Image、Audio 及 Video Extenders 管理與程式設計

DBvPlay


影像 音效 視訊
    X

開啟從屬站上的視訊播放程式,並播放一段視訊。 此視訊可儲存在視訊直欄或外部檔中:

若此視訊儲存在直欄中,Extender 會建立暫用檔,並從該直欄將物件內容複製到此暫用檔。 若視訊儲存在外部檔,而且無法使用環境變數中的值分辨它的相對檔名,或無法在從屬站機器上 存取此檔案,則 Extender 也可能會建立暫用檔。 此暫用檔會在使用 DB2VIDEOTEMP 環境變數指定的目錄中建立。 然後,Extender 會由暫用檔中播放該視訊。

授權

假設您所播放的是直欄中的視訊,請選取使用者表格上的權限。

檔案庫
OS/2 與 Windows AIX、HP-UX 及 Solaris
dmbvideo.lib libdmbvideo.a (AIX)

libdmbvideo.sl (HP-UX)

libdmbvideo.so (Solaris)

併入檔

dmbvideo.h

語法

播放儲存在直欄中的視訊

long DBvPlay(
      char *playerName,
      MMDB_PLAY_HANDLE,
      DB2Video *videoHandle,
      waitFlag
      );

語法

播放儲存成檔案的視訊

long DBvPlay(
      char *playerName,
     MMDB_PLAY_FILE,
      char *fileName,
      waitFlag
      );

參數

playerName (in)
視訊播放程式的名稱。假設您設為 NULL, 則會採用 DB2VIDEOPLAYER 環境變數所指定的預設視訊播放程式。

MMDB_PLAY_HANDLE (in)
此常數指出將視訊儲存成 BLOB。

MMDB_PLAY_FILE (in)
此常數指出將視訊儲存成可自從屬站存取的檔案。

videoHandle (in)
視訊的 handle。在您播放直欄中的視訊時, 必須傳遞此參數。假設視訊 handle 所呈現的是外部檔, 則會以從屬站環境變數 DB2VIDEOPATH 來分辨出檔案的位置。

fileName (in)
內含視訊的檔案名稱。API 會利用從屬站環境變數 DB2VIDEOPATH,分辨出檔案的位置。 您必須自從屬站工作站來存取該檔案。

waitFlag (in)
此常數是指出您的程式在繼續執行前,得花多久時間等待使用者關閉播放程式。 指定 MMDB_PLAY_WAIT,則會在和您的應用程式一樣的緒中執行播放程式; 指定 MMDB_PLAY_NO_WAIT,則是在個別緒中執行播放程式。

錯誤碼

MMDB_SUCCESS
API 呼叫程序執行成功。

MMDB_RC_NO_AUTH
呼叫程式不具備適當的存取權限。

MMDB_RC_NOT_CONNECTED
應用程式與資料庫之間無有效連接。

範例

播放 videoHandle 所識別的視訊。在和應用程式一樣的緒中執行預設播放程式:

#include <dmbvideo.h>
rc = DBvPlay(NULL, MMDB_PLAY_HANDLE, videoHandle,
                         MMDB_PLAY_WAIT);


[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]