Verwaltung und Programmierung

DBvPlay


Image Audio Video
    X

Ö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:

Kann die Wiedergabeeinheit nicht direkt auf das Video zugreifen, erstellt der Extender eine temporäre Datei in dem Verzeichnis, 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)

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

Search the DB2 Extender Books