IWiaMiniDrv：:d rvGetCapabilities 方法 (wiamindr_lh.h)
IWiaMiniDrv：:d rvGetCapabilities 方法會傳回裝置支援的事件和命令陣列。
語法
HRESULT drvGetCapabilities(
BYTE *__MIDL__IWiaMiniDrv0048,
LONG __MIDL__IWiaMiniDrv0049,
LONG *__MIDL__IWiaMiniDrv0050,
WIA_DEV_CAP_DRV **__MIDL__IWiaMiniDrv0051,
LONG *__MIDL__IWiaMiniDrv0052
);
參數
__MIDL__IWiaMiniDrv0048
lFlags [in]
指定 ppCapabilites 所指向的陣列是由命令或事件或兩者所組成。 此參數可以是下列其中一個旗標，或是 OR 運算子結合的兩個旗標。
| 旗標 | 描述 |
|---|---|
| WIA_DEVICE_COMMANDS | 陣列是由裝置命令所組成。 |
| WIA_DEVICE_EVENTS | 陣列是由裝置事件所組成。 |
__MIDL__IWiaMiniDrv0049
pWiasContext [in]
WIA 專案內容的指標。
__MIDL__IWiaMiniDrv0050
pcelt [out]
指向將接收 ppCapabilities 參數所指向數位中元素數目的記憶體位置。
__MIDL__IWiaMiniDrv0051
plDevErrVal [out]
指向將接收此方法狀態代碼的記憶體位置。 如果此方法傳回 S_OK，則儲存的值會是零。 否則，迷你驅動程式特定的錯誤碼會儲存在此參數所指向的位置。
__MIDL__IWiaMiniDrv0052
ppCapabilities [out， optional]
指向記憶體位置，該位置會接收 WIA_DEV_CAP_DRV 結構陣列中第一個元素的位址，其中包含裝置所支援之事件和命令的 GUID。
傳回值
成功時，方法應該會 傳回S_OK ，並清除 plDevErrVal 所指向的裝置錯誤值。 如果方法失敗，它應該會傳回標準 COM 錯誤碼，並將minidriver特定錯誤碼值放在 plDevErrVal 指向的記憶體中。
plDevErrVal 所指向的值可以藉由呼叫 IWiaMiniDrv：:d rvGetDeviceErrorStr 來轉換成字符串。
備註
WIA 服務會呼叫 minidriver 方法 IWiaMiniDrv：:d rvGetCapabilities ，以取得硬體命令功能和/或裝置事件的清單。 為了回應此呼叫，迷你驅動程式會將 ppCapabilities 設定為 GUID 數據指標陣列的位址。 每個 GUID 都會對應至映像裝置所支援的事件通知或裝置命令。 當 lFlags 參數設定為 WIA_DEVICE_COMMANDS 時，GUID 的陣列會包含裝置命令。 當 lFlags 設定為WIA_DEVICE_EVENTS時，GUID 的陣列會包含事件。 如果 lFlags 設定為 WIA_DEVICE_COMMANDS |WIA_DEVICE_EVENTS，GUID 的數位同時包含依該順序列出的事件和命令。
Wiadef.h 標頭會列出數個預先定義的命令和事件。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | wiamindr_lh.h (包含 Wiamindr.h) |