Extensions Image, Audio et Vidéo Administration et programmation

DBaPlay


Image Audio Vidéo
  X  

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 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 ]