IWiaDevMgr::Metode CreateDevice (wia_xp.h)

IWiaDevMgr::CreateDevice membuat pohon hierarki objek IWiaItem untuk perangkat Windows Image Acquisition (WIA).

Sintaks

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

Parameter

[in] bstrDeviceID

Jenis: BSTR

Menentukan pengidentifikasi unik perangkat WIA.

[out] ppWiaItemRoot

Jenis: IWiaItem**

Arahkan ke penunjuk ke antarmuka IWiaItem dari item akar di pohon hierarkis untuk perangkat WIA.

Menampilkan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Aplikasi menggunakan metode IWiaDevMgr::CreateDevice untuk membuat objek perangkat untuk perangkat WIA yang ditentukan oleh parameter bstrDeviceID .

Ketika kembali, metode IWiaDevMgr::CreateDevice menyimpan alamat pointer dalam parameter ppWiaItemRoot. Pointer menunjuk ke item akar pohon objek IWiaItem yang dibuat oleh IWiaDevMgr::CreateDevice. Aplikasi dapat menggunakan pohon objek ini untuk mengontrol dan mengambil data dari perangkat WIA.

Perhatikan bahwa aplikasi harus memanggil metode IUnknown::Release pada pointer yang mereka terima melalui parameter ppWiaItemRoot .

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	wia_xp.h (termasuk Wia.h)
Pustaka	Wiaguid.lib
DLL	Wiaservc.dll