Metode IWiaMiniDrv::d rvGetCapabilities (wiamindr_lh.h)
Metode IWiaMiniDrv::d rvGetCapabilities mengembalikan array peristiwa dan perintah yang didukung perangkat.
Sintaks
HRESULT drvGetCapabilities(
BYTE *__MIDL__IWiaMiniDrv0048,
LONG __MIDL__IWiaMiniDrv0049,
LONG *__MIDL__IWiaMiniDrv0050,
WIA_DEV_CAP_DRV **__MIDL__IWiaMiniDrv0051,
LONG *__MIDL__IWiaMiniDrv0052
);
Parameter
__MIDL__IWiaMiniDrv0048
lFlags [in]
Menentukan apakah array yang ditujukan oleh ppCapabilites terdiri dari perintah, atau peristiwa, atau keduanya. Parameter ini dapat berupa salah satu dari bendera berikut atau keduanya digabungkan oleh operator OR.
| Bendera | Deskripsi |
|---|---|
| WIA_DEVICE_COMMANDS | Array terdiri dari perintah perangkat. |
| WIA_DEVICE_EVENTS | Array terdiri dari peristiwa perangkat. |
__MIDL__IWiaMiniDrv0049
pWiasContext [in]
Arahkan ke konteks item WIA.
__MIDL__IWiaMiniDrv0050
pcelt [out]
Menunjuk ke lokasi memori yang akan menerima jumlah elemen dalam array yang ditujukkan oleh parameter ppCapabilities .
__MIDL__IWiaMiniDrv0051
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 ditujukan oleh parameter ini.
__MIDL__IWiaMiniDrv0052
ppCapabilities [keluar, opsional]
Menunjuk ke lokasi memori yang akan menerima alamat elemen pertama dari array struktur WIA_DEV_CAP_DRV yang berisi GUID peristiwa dan perintah yang didukung perangkat.
Nilai kembali
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 diarahkan oleh plDevErrVal dapat dikonversi ke string dengan memanggil IWiaMiniDrv::d rvGetDeviceErrorStr.
Keterangan
Layanan WIA memanggil metode minidriver IWiaMiniDrv::d rvGetCapabilities untuk mendapatkan daftar kemampuan perintah perangkat keras dan/atau peristiwa perangkat. Menanggapi panggilan ini, minidriver mengatur ppCapabilities dengan alamat array pointer ke data GUID. Setiap GUID sesuai dengan pemberitahuan peristiwa atau perintah perangkat yang didukung oleh perangkat pencitraan. Ketika parameter lFlags diatur ke WIA_DEVICE_COMMANDS, array GUID berisi perintah perangkat. Ketika lFlags diatur ke WIA_DEVICE_EVENTS, array GUID berisi peristiwa. Jika lFlags diatur ke WIA_DEVICE_COMMANDS | WIA_DEVICE_EVENTS, array GUID berisi peristiwa dan perintah, yang tercantum dalam urutan tersebut.
Header Wiadef.h mencantumkan beberapa perintah dan peristiwa yang telah ditentukan sebelumnya.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | wiamindr_lh.h (termasuk Wiamindr.h) |