wiauGetValidFormats 函式 (wiautil.h)

wiauGetValidFormats 函式會呼叫 IWiaMiniDrv：:d rvGetWiaFormatInfo 方法，並使用指定的 tymed 值建立有效格式的清單。

語法

HRESULT wiauGetValidFormats(
  [in]  IWiaMiniDrv *pDrv,
  [in]  BYTE        *pWiasContext,
        LONG        TymedValue,
  [out] int         *pNumFormats,
  [out] GUID        **ppFormatArray
);

參數

[in] pDrv

指向 WIA 迷你驅動程序物件。 此參數應該設定為 這個。

[in] pWiasContext

WIA 專案內容的指標。

TymedValue

指定要搜尋的 tymed 值。

[out] pNumFormats

接收格式數目的記憶體位置指標。

[out] ppFormatArray

接收格式 GUID 陣列位址的記憶體位置指標。

傳回值

成功時，函式會傳回S_OK。 如果函式失敗，它會傳回標準 COM 錯誤。

備註

此函式的呼叫端會負責使用 delete[] 運算符釋放格式陣列。

規格需求

需求	值
目標平台	桌面
標頭	wiautil.h (包括 Wiautil.h)