capGetDriverDescriptionA 函式 (vfw.h)

capGetDriverDescription 函式會擷取擷取驅動程式的版本描述。

語法

BOOL VFWAPI capGetDriverDescriptionA(
  UINT  wDriverIndex,
  LPSTR lpszName,
  int   cbName,
  LPSTR lpszVer,
  int   cbVer
);

wDriverIndex

擷取驅動程式的索引。索引的範圍可以從 0 到 9。

先列舉隨插即用擷取驅動程式，後面接著登錄中列出的擷取驅動程式，接著接著 SYSTEM.INI 中列出的擷取驅動程式。

lpszName

緩衝區的指標，其中包含對應至擷取驅動程式名稱的 Null 終止字串。

cbName

lpszName所指向之緩衝區的長度，以位元組為單位。

lpszVer

緩衝區的指標，其中包含對應至擷取驅動程式描述的 Null 終止字串。

cbVer

lpszVer所指向之緩衝區的長度，以位元組為單位。

如果成功或 FALSE，則傳回 TRUE 。否則傳回 TRUE 。

如果資訊描述的長度超過其緩衝區，則會截斷描述。傳回的字串一律為 null 終止。如果緩衝區大小為零，則不會複製其對應的描述。

注意

vfw.h 標頭會根據 UNICODE 預處理器常數的定義，將 capGetDriverDescription 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。