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)