Extensions Image, Audio et Vidéo Administration et programmation

DBvPlay


Image Audio Vidéo
    X

Ouvre le lecteur vidéo sur le poste client et lit une séquence vidéo. Celle-ci peut être stockée dans une colonne Vidéo ou dans un fichier externe.

Si les données vidéo sont stockées dans une colonne, l'extension crée un fichier temporaire et copie dans celui-ci le contenu de l'objet à partir de la colonne. L'extension peut également créer un fichier temporaire si les données vidéo sont stockées dans un fichier externe, si le nom relatif de celui-ci ne peut pas être résolu à l'aide des variables d'environnement ou si ce fichier n'est pas accessible sur le poste client. Ce fichier est créé dans le répertoire désigné par la variable d'environnement DB2VIDEOTEMP. L'extension lit ensuite la séquence vidéo à partir du fichier temporaire.

Autorisation

SELECT sur la table utilisateur si une séquence vidéo est lue à partir d'une colonne.

Fichier bibliothèque
OS/2 et Windows AIX, HP-UX et Solaris
dmbvideo.lib libdmbvideo.a (AIX)

libdmbvideo.sl (HP-UX)

libdmbvideo.so (Solaris)

Fichier d'inclusion

dmbvideo.h

Syntaxe

Lecture d'un objet vidéo stocké dans une colonne

long DBvPlay(
      char *playerName,
      MMDB_PLAY_HANDLE,
      DB2Video *videoHandle,
      waitFlag
      );

Syntaxe

Lecture d'un objet vidéo stocké dans un fichier

long DBvPlay(
      char *playerName,
      MMDB_PLAY_FILE,
      char *fileName,
      waitFlag
      );

Paramètres

playerName (entrée)
Nom du lecteur vidéo. Si ce paramètre a une valeur NULL, le lecteur vidéo par défaut défini par la variable d'environnement DB2VIDEOPLAYER est utilisé.

MMDB_PLAY_HANDLE (entrée)
Constante qui indique que la séquence vidéo est stockée dans une colonne.

MMDB_PLAY_FILE (entrée)
Constante qui indique que la séquence vidéo est stockée sous forme de fichier accessible à partir du poste client.

videoHandle (entrée)
Descripteur de la séquence vidéo. Ce paramètre doit être communiqué lorsque vous faites défiler une séquence vidéo dans une colonne. Si le descripteur vidéo représente un fichier externe, la variable d'environnement client DB2VIDEOPATH est utilisée pour déterminer l'emplacement du fichier.

fileName (entrée)
Nom du fichier contenant la séquence vidéo. L'API utilise la variable d'environnement DB2VIDEOPATH pour chercher l'emplacement du fichier. Le fichier doit être accessible à partir du poste client.

waitFlag (entrée)
Constante qui indique si le programme attend que l'utilisateur arrête le lecteur avant de continuer. Le paramètre MMDB_PLAY_WAIT entraîne la mise en oeuvre du lecteur dans la même unité d'exécution que l'application. Le paramètre MMDB_PLAY_NO_WAIT entraîne la mise en oeuvre du lecteur dans une unité d'exécution distincte.

Codes d'erreur

MMDB_SUCCESS
Le traitement de l'appel d'API a abouti.

MMDB_RC_NO_AUTH
Le demandeur ne dispose pas des droits d'accès corrects.

MMDB_RC_NOT_CONNECTED
L'application n'a pas établi une connexion correcte à une base de données.

Exemples

Lecture de la séquence vidéo identifiée par le descripteur vidéo. Mise en oeuvre du lecteur par défaut dans la même unité d'exécution que l'application.

#include <dmbvideo.h>
 
rc = DBvPlay(NULL, MMDB_PLAY_HANDLE,
       MMDB_PLAY_WAIT);


[ Début de page | Page précédente | Page suivante | Table des matières | Index ]