IWiaDevMgr::CreateDevice メソッド (wia_xp.h)

IWiaDevMgr::CreateDevice は、Windows イメージ取得 (WIA) デバイスの IWiaItem オブジェクトの階層ツリーを作成します。

構文

HRESULT CreateDevice(
  [in]  BSTR     bstrDeviceID,
  [out] IWiaItem **ppWiaItemRoot
);

パラメーター

[in] bstrDeviceID

種類: BSTR

WIA デバイスの一意識別子を指定します。

[out] ppWiaItemRoot

種類: IWiaItem**

WIA デバイスの階層ツリー内のルート項目の IWiaItem インターフェイスへのポインターへのポインター。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

アプリケーションでは 、IWiaDevMgr::CreateDevice メソッドを使用して 、bstrDeviceID パラメーターで指定された WIA デバイスのデバイス オブジェクトを作成します。

IWiaDevMgr::CreateDevice メソッドは、 パラメーター ppWiaItemRoot にポインターのアドレスを格納します。 ポインターは、IWiaDevMgr::CreateDevice によって作成された IWiaItem オブジェクトのツリーのルート項目を指します。 アプリケーションでは、このオブジェクト ツリーを使用して、WIA デバイスからデータを制御および取得できます。

アプリケーションは、ppWiaItemRoot パラメーターを介して受け取るポインターで IUnknown::Release メソッドを呼び出す必要があることに注意してください。

要件

サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	wia_xp.h (Wia.h を含む)
Library	Wiaguid.lib
[DLL]	Wiaservc.dll