IWiaMiniDrv::d rvInitializeWia メソッド (wiamindr_lh.h)

[アーティクル]
03/05/2024

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 メソッドが呼び出されます。