IWiaMiniDrv::d rvDeviceCommand メソッド (wiamindr_lh.h)
IWiaMiniDrv::d rvDeviceCommand メソッドは、WIA デバイスにコマンドを発行します。
構文
HRESULT drvDeviceCommand(
BYTE *__MIDL__IWiaMiniDrv0043,
LONG __MIDL__IWiaMiniDrv0044,
const GUID *__MIDL__IWiaMiniDrv0045,
IWiaDrvItem **__MIDL__IWiaMiniDrv0046,
LONG *__MIDL__IWiaMiniDrv0047
);
パラメーター
__MIDL__IWiaMiniDrv0043
lFlags [in]
予約済み。
__MIDL__IWiaMiniDrv0044
pWiasContext [in]
WIA 項目コンテキストへのポインター。
__MIDL__IWiaMiniDrv0045
plCommand [in]
WIA コマンド GUID をポイントします。
__MIDL__IWiaMiniDrv0046
plDevErrVal [out]
このメソッドの状態コードを受け取るメモリの場所を指します。 このメソッドが S_OKを返す場合、格納される値は 0 になります。 それ以外の場合、ミニドライバー固有のエラー コードは、このパラメーターが指す場所に格納されます。
__MIDL__IWiaMiniDrv0047
ppWiaDrvItem [out, optional]
IWiaDrvItem インターフェイスへのポインターを受け取ることができるメモリの場所を指します。 以下の解説を参照してください。
戻り値
成功した場合、メソッドは S_OK を返し、 plDevErrVal が指すデバイス エラー値をクリアする必要があります。 メソッドが失敗した場合は、標準の COM エラー コードを返し、 plDevErrVal が指すメモリにミニドライバー固有のエラー コード値を配置する必要があります。
plDevErrVal が指す値は、IWiaMiniDrv::d rvGetDeviceErrorStr を呼び出すことで文字列に変換できます。
注釈
メソッド IWiaMiniDrv::d rvDeviceCommand は、WIA サービスまたはアプリケーションによって生成されたコマンドをデバイスに発行するために WIA サービスによって呼び出されます。 WIA サービスは、デバイスが IWiaMiniDrv::d rvGetCapabilities メソッドでサポートできるコマンドに対して IWiaMiniDrv::d rvDeviceCommand メソッドのみを呼び出します。
ミニドライバーは通常、指すメモリの場所を設定しないため、 ppWiaDrvItem パラメーターは省略可能と見なす必要があります。 ただし、特定のコマンドでは、ミニドライバーは、このパラメーターが指す場所に新しく作成された項目のアドレスを配置します。 たとえば、写真を撮影するコマンドが発行された場合 (plCommand がWIA_CMD_TAKE_PICTUREに設定されている場合)、デバイスは新しいイメージを生成し、ミニドライバーがドライバー項目ツリーに新しい項目を作成し、*ppWiaDrvItem を新しい項目のアドレスに設定します。 これにより、新しい項目が作成されたことを WIA サービスに通知します。
ミニドライバーには、デバイスが IWiaMiniDrv::d rvGetCapabilities メソッドでサポートできるカスタム コマンドの一覧を含めることができます。
WIA サービスでは、このメソッドを呼び出す前にプロパティは書き込まれません。 コマンドがプロパティ設定に依存している場合、ミニドライバーはコマンドを発行する前 に IWiaMiniDrv::d rvWriteItemProperties を呼び出す必要があります。 たとえば、写真を撮影するコマンド (WIA_CMD_TAKE_PICTURE) は、シャッター速度と絞り設定に依存する場合があります。これは、コマンドを発行する前にデバイスに書き込む必要があります。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | wiamindr_lh.h (Wiamindr.h を含む) |