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を返す場合、格納される値は 0 になります。 それ以外の場合、ミニドライバー固有のエラー コードは、このパラメーターが指す場所に格納されます。
__MIDL__IWiaMiniDrv0052
ppCapabilities [out, optional]
デバイスがサポートするイベントとコマンドの GUID を含む WIA_DEV_CAP_DRV 構造体の配列の最初の要素のアドレスを受け取るメモリの場所を指します。
戻り値
成功した場合、メソッドは S_OK を返し、 plDevErrVal が指すデバイス エラー値をクリアする必要があります。 メソッドが失敗した場合は、標準の COM エラー コードを返し、 plDevErrVal が指すメモリにミニドライバー固有のエラー コード値を配置する必要があります。
plDevErrVal が指す値は、IWiaMiniDrv::d rvGetDeviceErrorStr を呼び出すことで文字列に変換できます。
注釈
WIA サービスは、ミニドライバー メソッド IWiaMiniDrv::d rvGetCapabilities を呼び出して、ハードウェア コマンド機能やデバイス イベントの一覧を取得します。 この呼び出しに応じて、ミニドライバーは、GUID データへのポインターの配列のアドレスを使用して ppCapabilities を設定します。 各 GUID は、イメージング デバイスでサポートされているイベント通知またはデバイス コマンドに対応します。 lFlags パラメーターが WIA_DEVICE_COMMANDS に設定されている場合、GUID の配列にはデバイス コマンドが含まれます。 lFlags が WIA_DEVICE_EVENTS に設定されている場合、GUID の配列にはイベントが含まれます。 lFlags が WIA_DEVICE_COMMANDS | に設定されている場合WIA_DEVICE_EVENTS、GUID の配列には、イベントとコマンドの両方が含まれており、その順序で一覧表示されます。
Wiadef.h ヘッダーには、いくつかの定義済みのコマンドとイベントが一覧表示されます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | wiamindr_lh.h (Wiamindr.h を含む) |