IWiaMiniDrv：:d rvGetWiaFormatInfo 方法 (wiamindr_lh.h)
IWiaMiniDrv：:d rvGetWiaFormatInfo 方法會尋找 WIA 硬體裝置支援的影像格式和媒體類型。
語法
HRESULT drvGetWiaFormatInfo(
BYTE *__MIDL__IWiaMiniDrv0059,
LONG __MIDL__IWiaMiniDrv0060,
LONG *__MIDL__IWiaMiniDrv0061,
WIA_FORMAT_INFO **__MIDL__IWiaMiniDrv0062,
LONG *__MIDL__IWiaMiniDrv0063
);
參數
__MIDL__IWiaMiniDrv0059
lFlags [in]
保留的。
__MIDL__IWiaMiniDrv0060
pWiasContext [in]
WIA 專案內容的指標。
__MIDL__IWiaMiniDrv0061
pcelt [out]
指向將接收 ppwfi所指向數位中項目數的記憶體位置。
__MIDL__IWiaMiniDrv0062
plDevErrVal [out]
指向將接收此方法狀態代碼的記憶體位置。 如果這個方法傳回S_OK，則儲存的值會是零。 否則，minidriver 特定的錯誤碼會儲存在此參數所指向的位置。
__MIDL__IWiaMiniDrv0063
ppwfi [out， optional]
指向將接收 WIA_FORMAT_INFO 結構陣列之第一個專案位址的記憶體位置。
傳回值
成功時，方法應該會傳回 S_OK ，並清除 plDevErrVal 所指向的裝置錯誤值。 如果針對不包含任何數據的專案呼叫這個方法，它應該會傳回 E_INVALIDARG。 如果方法失敗，它應該會傳回標準 COM 錯誤碼，並將minidriver特定的錯誤碼值放在 plDevErrVal 所指向的記憶體中。
plDevErrVal 所指向的值可以藉由呼叫 IWiaMiniDrv：:d rvGetDeviceErrorStr 來轉換成字符串。
備註
這個方法會建立 WIA_FORMAT_INFO 結構的數位，描述 WIA 硬體裝置支援的媒體類型和影像格式。 針對陣列中的每個元素，媒體類型可以是其中一個 TYMED_CALLBACK、 TYMED_MULTIPAGE_CALLBACK、 TYMED_FILE或 TYMED_MULTIPAGE_FILE。 影像格式的一般值包括WiaImgFmt_JPEG，以及WiaImgFmt_BMP等等。 如需詳細資訊，請參閱 瞭解 TYMED 和 WIA_IPA_FILENAME_EXTENSION。
minidriver 可以定義全域數位保存 WIA_FORMAT_INFO 結構，也可以配置數位的記憶體。 WIA 服務不會釋放配置的記憶體，因此迷你驅動程式應該將該記憶體的指標儲存在驅動程式項目內容中。 minidriver 接著可以在 呼叫 IWiaMiniDrv：:d rvFreeDrvItemContext 中釋放此記憶體。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | wiamindr_lh.h (包括 Wiamindr.h) |