Metode IWiaMiniDrv::d rvInitializeWia (wiamindr_lh.h)
Metode IWiaMiniDrv::d rvInitializeWia menginisialisasi minidriver dan membangun pohon item driver yang mewakili perangkat.
Sintaks
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
);
Parameter
__MIDL__IWiaMiniDrv0000
bstrDeviceID [in]
Menentukan string yang berisi pengidentifikasi unik perangkat.
__MIDL__IWiaMiniDrv0001
bstrRootFullItemName [in]
Menentukan string yang berisi nama lengkap item akar.
__MIDL__IWiaMiniDrv0002
lFlags [in]
Dicadangkan. Atur ke nol.
__MIDL__IWiaMiniDrv0003
pIUnknownOuter [in, opsional]
(Opsional) Menunjuk ke lokasi memori yang dapat menerima alamat antarmuka IUnknown .
__MIDL__IWiaMiniDrv0004
pStiDevice [in, opsional]
Menunjuk ke Antarmuka IStiDevice COM.
__MIDL__IWiaMiniDrv0005
pWiasContext [in]
Arahkan ke konteks item WIA.
__MIDL__IWiaMiniDrv0006
plDevErrVal [out]
Menunjuk ke lokasi memori yang akan menerima kode status untuk metode ini. Jika metode ini mengembalikan S_OK, nilai yang disimpan akan menjadi nol. Jika tidak, kode kesalahan khusus minidriver akan disimpan di lokasi yang ditujukkan oleh parameter ini.
__MIDL__IWiaMiniDrv0007
ppIDrvItemRoot [keluar, opsional]
Menunjuk ke lokasi memori yang akan menerima alamat Antarmuka IWiaDrvItem, antarmuka item akar.
__MIDL__IWiaMiniDrv0008
ppIUnknownInner [keluar, opsional]
(Opsional) Menunjuk ke lokasi memori yang dapat menerima alamat antarmuka IUnknown . Jika minidriver memiliki fungsionalitas yang tidak dapat diakses melalui antarmuka IWiaMiniDrv , vendor dapat membuat antarmuka terpisah pada minidriver. Parameter ini menyediakan akses ke fungsionalitas tersebut.
Mengembalikan nilai
Jika berhasil, metode harus mengembalikan S_OK dan menghapus nilai kesalahan perangkat yang ditunjukkan oleh plDevErrVal. Jika metode gagal, metode harus mengembalikan kode kesalahan COM standar dan menempatkan nilai kode kesalahan khusus minidriver dalam memori yang ditunjukkan oleh plDevErrVal.
Nilai yang ditujukkan oleh plDevErrVal dapat dikonversi ke string dengan memanggil IWiaMiniDrv::d rvGetDeviceErrorStr.
Keterangan
Metode ini harus menginisialisasi struktur privat apa pun dan membuat pohon item driver. Untuk informasi terperinci tentang langkah-langkah yang biasanya dilakukan para minidriver dalam metode ini, lihat Menginisialisasi Wia Minidriver dan Membuat Pohon Item Driver WIA.
Layanan WIA memanggil metode IWiaMiniDrv::d rvInitializeWia sebagai respons terhadap panggilan klien ke fungsi CreateDevice , yang berarti bahwa metode ini dipanggil sekali untuk setiap koneksi klien baru.
Misalnya, jika pengguna mengklik kanan ikon pemindai WIA di Komputer Saya, shell memanggil CreateDevice, yang menghasilkan panggilan ke metode IWiaMiniDrv::d rvInitializeWia minidriver. Jika pengguna kemudian menjalankan Wisaya Akuisisi WIA, pengguna juga memanggil CreateDevice. Setiap kali CreateDevice dipanggil, ada panggilan yang sesuai ke metode IWiaMiniDrv::d rvInitializeWia pada minidriver.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | wiamindr_lh.h (termasuk Wiamindr.h) |
Lihat juga
IWiaMiniDrv::d rvGetDeviceErrorStr