IStiDevice::Metode escape (sti.h)
Metode IStiDevice::Escape mengirimkan permintaan untuk operasi I/O khusus vendor ke perangkat gambar diam.
Sintaks
HRESULT Escape(
[in] STI_RAW_CONTROL_CODE EscapeFunction,
[in] LPVOID lpInData,
DWORD cbInDataSize,
[in, out] LPVOID pOutData,
DWORD dwOutDataSize,
[out] LPDWORD pdwActualData
);
Parameter
[in] EscapeFunction
Nilai yang disediakan pemanggil, ditentukan vendor, berukuran DWORD yang mewakili operasi I/O. Minidriver perangkat harus mengenali nilai ini dan harus mengekspor antarmuka IStiUSD . Nilai yang ditentukan vendor harus lebih besar dari STI_RAW_RESERVED, yang didefinisikan dalam Sti.h.
[in] lpInData
Penunjuk yang disediakan penelepon ke buffer yang berisi data yang akan dikirim ke perangkat.
cbInDataSize
Panjang yang disediakan penelepon, dalam byte, dari data yang terkandung dalam buffer yang ditujukkan oleh lpInData.
[in, out] pOutData
Penunjuk yang disediakan penelepon ke buffer memori untuk menerima data dari perangkat.
dwOutDataSize
Panjang yang disediakan penelepon, dalam byte, dari buffer yang diacu oleh lpOutData.
[out] pdwActualData
Menerima jumlah byte yang benar-benar ditulis ke pOutData.
Nilai kembali
Jika operasi berhasil, metode akan mengembalikan S_OK. Jika tidak, ia mengembalikan salah satu kode kesalahan berawalan STIERR yang ditentukan dalam stierr.h.
Keterangan
Metode IStiDevice::Escape memanggil IStiUSD::Escape, yang diekspor oleh minidriver yang disediakan vendor. Minidriver perangkat menentukan penggunaan parameter Metode.
Sebelum memanggil IStiDevice::Escape, klien antarmuka IStiDevice COM harus memanggil IStillImage::CreateDevice untuk mendapatkan penunjuk antarmuka IStiDevice , yang menyediakan akses ke perangkat tertentu.
Panggilan ke IStiDevice::Escape harus didahului dengan panggilan ke IStiDevice::LockDevice dan diikuti dengan panggilan ke IStiDevice::UnLockDevice.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | sti.h (termasuk Sti.h) |