IWiaMiniDrv::d rvInitializeWia メソッド (wiamindr_lh.h)
IWiaMiniDrv::d rvInitializeWia メソッドは、ミニドライバーを初期化し、デバイスを表すドライバー項目ツリーをビルドします。
構文
HRESULT drvInitializeWia(
BYTE *__MIDL__IWiaMiniDrv0000,
LONG __MIDL__IWiaMiniDrv0001,
BSTR __MIDL__IWiaMiniDrv0002,
BSTR __MIDL__IWiaMiniDrv0003,
IUnknown *__MIDL__IWiaMiniDrv0004,
IUnknown *__MIDL__IWiaMiniDrv0005,
IWiaDrvItem **__MIDL__IWiaMiniDrv0006,
IUnknown **__MIDL__IWiaMiniDrv0007,
LONG *__MIDL__IWiaMiniDrv0008
);
パラメーター
__MIDL__IWiaMiniDrv0000
bstrDeviceID [in]
デバイスの一意識別子を含む文字列を指定します。
__MIDL__IWiaMiniDrv0001
bstrRootFullItemName [in]
ルート項目の完全な名前を含む文字列を指定します。
__MIDL__IWiaMiniDrv0002
lFlags [in]
引っ込み思案。 0 に設定します。
__MIDL__IWiaMiniDrv0003
pIUnknownOuter [in, optional]
(省略可能)IUnknown インターフェイスのアドレスを受け取ることができるメモリの場所を指します。
__MIDL__IWiaMiniDrv0004
pStiDevice [in, optional]
IStiDevice COM インターフェイスを指します。
__MIDL__IWiaMiniDrv0005
pWiasContext [in]
WIA 項目コンテキストへのポインター。
__MIDL__IWiaMiniDrv0006
plDevErrVal [out]
このメソッドの状態コードを受け取るメモリの場所を指します。 このメソッドが S_OKを返す場合、格納される値は 0 になります。 それ以外の場合、ミニドライバー固有のエラー コードは、このパラメーターが指す場所に格納されます。
__MIDL__IWiaMiniDrv0007
ppIDrvItemRoot [out, optional]
ルート項目のインターフェイスである IWiaDrvItem インターフェイスのアドレスを受け取るメモリ位置を指します。
__MIDL__IWiaMiniDrv0008
ppIUnknownInner [out, optional]
(省略可能)IUnknown インターフェイスのアドレスを受け取ることができるメモリの場所を指します。 ミニドライバーに、IWiaMiniDrv インターフェイスを介してアクセスできない機能がある場合、ベンダーはミニドライバーに別のインターフェイスを作成できます。 このパラメーターは、その機能へのアクセスを提供します。
戻り値
成功した場合、メソッドは S_OK を返し、plDevErrVal によって指デバイス エラー値をクリアする必要があります。 メソッドが失敗した場合は、標準の COM エラー コードを返し、plDevErrVal によって指されるメモリにミニドライバー固有のエラー コード値配置する必要があります。
plDevErrVal 指す値は、IWiaMiniDrv::d rvGetDeviceErrorStr 呼び出すことによって、文字列に変換できます。
備考
このメソッドは、プライベート構造体を初期化し、ドライバー項目ツリーを作成する必要があります。 ミニドライバーがこのメソッドで通常実行する手順の詳細については、「WIA ミニドライバー の初期化 と WIA ドライバー項目ツリー の作成を参照してください。
WIA サービスは、CreateDevice 関数に対するクライアントの呼び出しに応答して、IWiaMiniDrv::d rvInitializeWia メソッドを呼び出します。これは、このメソッドが新しいクライアント接続ごとに 1 回呼び出されることを意味します。
たとえば、ユーザーが [マイ コンピューター] で WIA スキャナー アイコン右クリックすると、シェルは CreateDevice を呼び出し、ミニドライバーの IWiaMiniDrv::d rvInitializeWia メソッドへの呼び出しを生成します。 その後、ユーザーが WIA 取得ウィザードを実行すると、CreateDevice も呼び出されます。 CreateDevice 呼び出されるたびに、ミニドライバーの IWiaMiniDrv::d rvInitializeWia メソッドへの対応する呼び出しがあります。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | wiamindr_lh.h (Wiamindr.h を含む) |
関連項目
IWiaMiniDrv の
IWiaMiniDrv::d rvGetDeviceErrorStr