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

DBvBuildStoryboardTable


影像 音效 視訊
    X

在快照型錄內建置視訊中之所有快照的相關項目。來源視訊可放在資料庫或檔案中。 該快照型錄位於資料庫中。 API 會為每一個快照儲存來源視訊的相關 handle 或檔案資訊。 它也儲存至少一個代表框的快照號碼、起始框號碼、結束框號碼和資訊。 DBvStoryboardCtrl 資料結構中的值, 用以決定要用多少個呈現畫面來認定一個快照。對於其長度低於 DBvStoryboardCtrl 中之臨界值的快照而言, API 會視同一個呈現畫面;對於其長度界於 DBvStoryboardCtrl 中之高低臨界值間的快照而言, API 會視同兩個呈現畫面;就長度大於 DBvStoryboardCtrl 中的上限值的快照而言,API 可識別三個代表框。 呈現畫面資訊中會包括其畫面編號以及畫面資料。 儲存在快照型錄中的呈現畫面資訊, 可用來顯示故事板, 也就是顯示一則看得見的視訊摘要。

呼叫此 API 之前,應用程式必須先連接到資料庫。

授權

插入、控制

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

libdmbshot.sl (HP-UX)

libdmbshot.so (Solaris)

併入檔

dmbshot.h

語法

long DBvBuildStoryboardTable(
      char *catalogName,
      DBvIOType *video,
      DBvShotControl *shotCtrl,
      DBvStoryBoardCtrl *sbCtrl,
      SQLHDBC hdbc
      );

參數

catalogName (in)
指向快照型錄名稱的指標。

video (in)
指向視訊結構的指標。

shotCtrl (in)
指向快照控制結構的指標。

sbCtrl (in)
指向故事板控制結構的指標。

hdbc (in)
取自 SQLConnect 中的資料庫 handle。

錯誤碼

MMDB_SUCCESS
API 呼叫程序執行成功。

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

MMDB_RC_INVALID_CATALOG
型錄無效或不存在。

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

範例

在快照型錄 hotshots 中,建立視訊的相關項目:

#include <dmbshot.h>
rc = DBvBuildStoryboardTable("hotshots",
       video, &shotCtrl, &sbCtrl, hdbc);


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