Image, Audio und Video Extender Verwaltung und Programmierung
Öffnet die Wiedergabeeinheit für Videodaten auf dem Client und gibt ein
Video wieder. Das Video kann in einer Videospalte oder einer externen
Datei gespeichert sein:
- Ist das Video in einer externen Datei gespeichert, können Sie entweder den
Namen der Datei oder die Videokennung an diese API übergeben. Die API
verwendet die Client-Umgebungsvariable DB2VIDEOPATH, um die Dateiadresse
aufzulösen. Auf die Datei muß von der Client-Workstation aus
zugegriffen werden können.
- Ist das Video in einer Spalte gespeichert, müssen Sie die Videokennung an
die API übergeben. Die Anwendung muß mit der Datenbank verbunden sein
und über Lesezugriff auf die Tabelle verfügen, in der das Video gespeichert
ist.
Wenn das Video in einer Spalte gespeichert ist, erstellt der Extender eine
temporäre Datei und kopiert den Inhalt des Objekts aus der Spalte in die
Datei. Der Extender erstellt möglicherweise auch eine temporäre Datei,
wenn das Video in einer externen Datei gespeichert ist und wenn sein relativer
Dateinamen nicht unter Verwendung der Werte in Umgebungsvariablen aufgelöst
werden kann oder wenn die Datei auf der Client-Maschine nicht zugänglich
ist. Die temporäre Datei wird in dem Verzeichnis erstellt, das in der
Umgebungsvariablen DB2VIDEOTEMP angegeben ist. Der Extender gibt dann
das Video aus der temporären Datei wieder.
Berechtigung
Auswahlberechtigung (SELECT) für die Benutzertabelle, wenn ein Video in
einer Spalte wiedergegeben wird.
Bibliotheksdatei
OS/2 und Windows
| AIX, HP-UX und Solaris
|
dmbvideo.lib
| libdmbvideo.a (AIX)
|
| libdmbvideo.sl (HP-UX)
|
| libdmbvideo.so (Solaris)
|
Kopfdatei
dmbvideo.h
Syntax
Wiedergabe eines Videos, das in einer Spalte gespeichert ist
long DBvPlay(
char *playerName,
MMDB_PLAY_HANDLE,
DB2Video *videoHandle,
waitFlag
);
Syntax
Wiedergabe eines Videos, das als Datei gespeichert ist
long DBvPlay(
char *playerName,
MMDB_PLAY_FILE,
char *fileName,
waitFlag
);
Parameter
- playerName (Eingabe)
- Der Name der Videowiedergabeeinheit. Ist dieser Wert auf NULL
gesetzt, wird die Standardeinheit für die Videowiedergabe verwendet, die in
der Umgebungsvariablen DB2VIDEOPLAYER angegeben ist.
- MMDB_PLAY_HANDLE (Eingabe)
- Eine Konstante, die angibt, daß das Video in einer Spalte gespeichert
ist.
- MMDB_PLAY_FILE (Eingabe)
- Eine Konstante, die angibt, daß das Video als Datei gespeichert ist, auf
die vom Client aus zugegriffen werden kann.
- videoHandle (Eingabe)
- Die Kennung für das Video. Dieser Parameter muß übergeben werden,
wenn Sie ein Video in einer Spalte wiedergeben. Stellt die Videokennung
eine externe Datei dar, wird die Client-Umgebungsvariable DB2VIDEOPATH
verwendet, um die Dateiadresse aufzulösen.
- fileName (Eingabe)
- Der Name der Datei, die das Video enthält. Die API verwendet die
Client-Umgebungsvariable DB2VIDEOPATH, um die Dateiadresse aufzulösen.
Auf die Datei muß von der Client-Workstation aus zugegriffen werden
können.
- waitFlag (Eingabe)
- Eine Konstante, die angibt, ob das Programm vor dem Fortfahren wartet, bis
der Benutzer die Wiedergabeeinheit schließt. MMDB_PLAY_WAIT führt die
Wiedergabeeinheit auf demselben Thread aus wie Ihre Anwendung.
MMDB_PLAY_NO_WAIT führt die Wiedergabeeinheit auf einem separaten Thread
aus.
Fehlercodes
- MMDB_SUCCESS
- API-Aufruf erfolgreich verarbeitet.
- MMDB_RC_NO_AUTH
- Aufrufender verfügt nicht über die korrekte Zugriffsberechtigung.
- MMDB_RC_NOT_CONNECTED
- Keine gültige Verbindung zwischen Anwendung und Datenbank.
Beispiele
Wiedergeben des Videos, das durch 'videoHandle' identifiziert
ist. Ausführen der Standardwiedergabeeinheit auf demselben Thread wie
die Anwendung:
#include <dmbvideo.h>
rc = DBvPlay(NULL, MMDB_PLAY_HANDLE, videoHandle,
MMDB_PLAY_WAIT);
[ Seitenanfang | Vorherige Seite | Nächste Seite | Inhaltsverzeichnis | Index ]