Image、Audio 及 Video Extenders 管理與程式設計
開啟從屬站上的視訊播放程式,並播放一段視訊。
此視訊可儲存在視訊直欄或外部檔中:
- 若視訊是儲存在外部檔中,
則您可以將檔名或視訊 handle 傳遞給此 API。API 會利用從屬站環境變數
DB2VIDEOPATH,分辨出檔案的位置。
您必須自從屬站工作站來存取該檔案。
- 假設視訊是儲存在直欄中,則您必須將視訊 handle 傳遞給 API。
應用程式必須連接資料庫,而且必須有儲存視訊的表格的讀取權。
若此視訊儲存在直欄中,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);
[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]