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

DBaPlay


影像 音效 視訊
  X  

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

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

授權

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

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

libdmbaudio.sl (HP-UX)

libdmbaudio.so (Solaris)

併入檔

dmbaudio.h

語法

播放儲存於直欄中的一段音效

long DBaPlay(
      char *playerName,
      MMDB_PLAY_HANDLE,
      DB2Audio *audioHandle,
      waitFlag
      );

語法

播放儲存成檔案的一段音效

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

參數

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

MMDB_PLAY_HANDLE (in)
此常數指出將音效儲存成 BLOB。

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

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

fileName (in)
內含音效的檔案名稱。

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

錯誤碼

MMDB_SUCCESS
API 呼叫程序執行成功。

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

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

範例

播放由 audioHandle 識別的音效。在和應用程式一樣的緒中執行預設播放程式:

#include <dmbaudio.h>
rc = DBaPlay(NULL, MMDB_PLAY_HANDLE,
       audioHandle, MMDB_PLAY_WAIT);


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