Metode IWiaMiniDrv::d rvDeviceCommand (wiamindr_lh.h)
Metode IWiaMiniDrv::d rvDeviceCommand mengeluarkan perintah ke perangkat WIA.
Sintaks
HRESULT drvDeviceCommand(
BYTE *__MIDL__IWiaMiniDrv0043,
LONG __MIDL__IWiaMiniDrv0044,
const GUID *__MIDL__IWiaMiniDrv0045,
IWiaDrvItem **__MIDL__IWiaMiniDrv0046,
LONG *__MIDL__IWiaMiniDrv0047
);
Parameter
__MIDL__IWiaMiniDrv0043
lFlags [in]
Dicadangkan.
__MIDL__IWiaMiniDrv0044
pWiasContext [in]
Arahkan ke konteks item WIA.
__MIDL__IWiaMiniDrv0045
plCommand [in]
Menunjuk ke PERINTAH WIA GUID.
__MIDL__IWiaMiniDrv0046
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__IWiaMiniDrv0047
ppWiaDrvItem [keluar, opsional]
Menunjuk ke lokasi memori yang dapat menerima pointer ke Antarmuka IWiaDrvItem. Lihat keterangan di bawah ini.
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 IWiaMiniDrv::d rvDeviceCommand dipanggil oleh layanan WIA untuk mengeluarkan layanan WIA atau perintah yang dihasilkan aplikasi ke perangkat. Layanan WIA hanya memanggil metode IWiaMiniDrv::d rvDeviceCommand untuk perintah yang dapat didukung perangkat dalam metode IWiaMiniDrv::d rvGetCapabilities.
Parameter ppWiaDrvItem harus dianggap opsional, karena minidriver biasanya tidak mengatur lokasi memori yang dirujuknya. Namun, untuk perintah tertentu, minidriver menempatkan alamat item yang baru dibuat di lokasi yang ditujukkan oleh parameter ini. Misalnya, jika perintah untuk mengambil gambar dikeluarkan (plCommand diatur ke WIA_CMD_TAKE_PICTURE), perangkat menghasilkan gambar baru, menyebabkan minidriver membuat item baru di pohon item driver, dan mengatur *ppWiaDrvItem ke alamat item baru. Ini menginformasikan layanan WIA bahwa item baru dibuat.
Minidriver dapat menyertakan daftar perintah kustom yang dapat didukung perangkat dalam metode IWiaMiniDrv::d rvGetCapabilities.
Layanan WIA tidak menulis properti apa pun sebelum memanggil metode ini. Jika perintah bergantung pada pengaturan properti, minidriver harus memanggil IWiaMiniDrv::d rvWriteItemProperties sebelum mengeluarkan perintah. Misalnya, perintah untuk mengambil gambar, WIA_CMD_TAKE_PICTURE, mungkin mengandalkan pengaturan kecepatan rana dan bukaan, yang perlu ditulis ke perangkat sebelum perintah dikeluarkan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | wiamindr_lh.h (termasuk Wiamindr.h) |