Extensions Image, Audio et Vidéo Administration et programmation
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 la séquence vidéo est stockée dans un fichier externe, vous pouvez
communiquer le nom de ce fichier ou le descripteur vidéo à l'API.
L'API utilise la variable d'environnement DB2VIDEOPATH pour chercher
l'emplacement du fichier. Le fichier doit être accessible à partir
du poste client.
- Si la séquence vidéo est stockée dans une colonne, vous devez communiquer
le descripteur vidéo à l'API. L'application doit être
connectée à la base de données et avoir accès en lecture à la table dans
laquelle les données vidéo sont stockées.
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 ]