Extensions Image, Audio et Vidéo Administration et programmation
Ouvre le lecteur sur le poste client et lit une séquence audio. La
séquence peut être stockée dans une colonne Audio ou un fichier
externe.
- Si la séquence audio est stockée dans un fichier externe, vous pouvez
communiquer le nom de ce fichier ou le descripteur audio à l'API qui
utilise la variable d'environnement DB2AUDIOPATH pour déterminer
l'emplacement du fichier. Le fichier doit être accessible à partir
du poste client.
- Si la séquence audio est stockée dans une colonne, vous devez communiquer
le descripteur audio à 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 audio 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 audio 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 DB2AUDIOTEMP. L'extension lit ensuite la
séquence audio à partir de ce fichier temporaire.
Autorisation
SELECT sur la table utilisateur si une séquence audio est lue à partir
d'une colonne.
Fichier bibliothèque
OS/2 et Windows
| AIX, HP-UX et Solaris
|
dmbaudio.lib
| libdmbaudio.a (AIX)
|
| libdmbaudio.sl (HP-UX)
|
| libdmbaudio.so (Solaris)
|
Fichier d'inclusion
dmbaudio.h
Syntaxe
Lecture d'un objet audio stocké dans une colonne
long DBaPlay(
char *playerName,
MMDB_PLAY_HANDLE,
DB2Audio *audioHandle,
waitFlag
);
Syntaxe
Lecture d'un objet audio stocké dans un fichier
long DBaPlay(
char *playerName,
MMDB_PLAY_FILE,
char *fileName,
waitFlag
);
Paramètres
- playerName (entrée)
- Nom du lecteur audio. Si ce paramètre a une valeur NULL, le lecteur
audio par défaut défini par la variable d'environnement DB2AUDIOPLAYER
est utilisé.
- MMDB_PLAY_HANDLE (entrée)
- Constante qui indique que les données audio sont stockées en tant
qu'objet BLOB.
- MMDB_PLAY_FILE (entrée)
- Constante qui indique que les données audio sont stockées sous forme de
fichier accessible à partir du poste client.
- audioHandle (entrée)
- Descripteur de la séquence audio. Ce paramètre doit être fourni
lorsque vous lisez une séquence audio se trouvant dans une colonne. Si
le descripteur audio représente un fichier externe, la variable
d'environnement DB2VIDEOPATH est utilisée pour déterminer
l'emplacement du fichier.
- fileName (entrée)
- Nom du fichier contenant les données audio.
- 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 audio identifiée par le descripteur audio.
Mise en oeuvre du lecteur par défaut dans la même unité d'exécution que
l'application.
#include <dmbaudio.h>
rc = DBaPlay(NULL, MMDB_PLAY_HANDLE,
audioHandle, MMDB_PLAY_WAIT);
[ Début de page | Page précédente | Page suivante | Table des matières | Index ]