Metode IStiDevice::RawReadCommand (sti.h)

Metode IStiDevice::RawReadCommand membaca informasi perintah dari perangkat gambar diam.

Sintaks

HRESULT RawReadCommand(
  [in, out]      LPVOID       lpBuffer,
  [in, out]      LPDWORD      lpdwNumberOfBytes,
  [in, optional] LPOVERLAPPED lpOverlapped
);

Parameter

[in, out] lpBuffer

Penunjuk yang disediakan penelepon ke buffer untuk menerima data yang dibaca dari perangkat.

[in, out] lpdwNumberOfBytes

Penunjuk yang disediakan penelepon ke DWORD. Pemanggil harus memuat DWORD dengan jumlah byte dalam buffer yang diacu oleh lpBuffer. Saat dikembalikan, itu akan berisi jumlah byte yang benar-benar dibaca.

[in, optional] lpOverlapped

Penunjuk opsional yang disediakan penelepon ke struktur TUMPANG TINDIH (dijelaskan dalam dokumentasi Microsoft Windows SDK).

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::RawReadCommand memanggil IStiUSD::RawReadCommand, yang diekspor oleh minidriver yang disediakan vendor. Arti konten buffer ditentukan vendor.

Anda hanya perlu memanggil IStiDevice::RawReadCommand jika informasi perintah dan data dibaca dari perangkat dengan metode yang berbeda. Untuk perangkat lain, IStiDevice::RawReadData dapat digunakan untuk perintah dan data.

Sebelum memanggil IStiDevice::RawReadCommand, klien antarmuka IStiDevice COM harus memanggil IStillImage::CreateDevice untuk mendapatkan penunjuk antarmuka IStiDevice , yang menyediakan akses ke perangkat tertentu.

Panggilan ke IStiDevice::RawReadCommand 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)