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，則儲存的值會是零。 否則，minidriver 特定錯誤碼會儲存在此參數所指向的位置。
__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，以取得硬體命令功能和/或裝置事件的清單。 為了回應此呼叫，minidriver 會將 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） |