Metode IStiUSD::RawReadData (stiusd.h)

Metode IStiUSD::RawReadData minidriver gambar masih membaca data dari perangkat gambar diam.

Sintaks

HRESULT RawReadData(
  LPVOID       lpBuffer,
  LPDWORD      lpdwNumberOfBytes,
  LPOVERLAPPED lpOverlapped
);

Parameter

lpBuffer

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

lpdwNumberOfBytes

Penunjuk yang disediakan penelepon ke DWORD. Pemanggil memuat DWORD dengan jumlah byte dalam buffer yang diacu oleh lpBuffer. Driver harus mengganti nilai ini dengan jumlah byte yang benar-benar dibaca.

lpOverlapped

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

Nilai kembali

Jika operasi berhasil, metode harus mengembalikan S_OK. Jika tidak, itu harus mengembalikan salah satu kode kesalahan awalan STIERR yang ditentukan dalam stierr.h.

Keterangan

Minidriver gambar diam biasanya mengimplementasikan metode ini dengan memanggil ReadFile (dijelaskan dalam dokumentasi Windows SDK).

Untuk perangkat USB, performa yang lebih baik dapat dicapai jika permintaan baca selaras dengan batas ukuran paket maksimum. Ukuran paket maksimum dapat diperoleh dengan memanggil DeviceIoControl, menentukan kode kontrol I/O IOCTL_GET_CHANNEL_ALIGN_RQST .

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	stiusd.h (termasuk Stiusd.h)

Lihat juga

IStiDevice::RawReadData

IStiUSD