Metodo IStiUSD::RawReadData (stiusd.h)

Un metodo IStiUSD::RawReadData di un'immagine continua legge i dati da un dispositivo immagine ancora.

Sintassi

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

Parametri

lpBuffer

Puntatore fornito dal chiamante a un buffer per ricevere i dati letti dal dispositivo.

lpdwNumberOfBytes

Puntatore fornito dal chiamante a una DWORD. Il chiamante carica DWORD con il numero di byte nel buffer a cui punta lpBuffer. Il driver deve sostituire questo valore con il numero di byte effettivamente letti.

lpOverlapped

Puntatore facoltativo fornito dal chiamante a una struttura OVERLAPPED (descritta nella documentazione di Microsoft Windows SDK).

Valore restituito

Se l'operazione ha esito positivo, il metodo deve restituire S_OK. In caso contrario, deve restituire uno dei codici di errore prefissi STIERR definiti in stierr.h.

Commenti

Un minidriver di immagini ancora implementa in genere questo metodo chiamando ReadFile (descritto nella documentazione di Windows SDK).

Per i dispositivi USB, è possibile ottenere prestazioni migliori se le richieste di lettura sono allineate ai limiti massimi delle dimensioni dei pacchetti. Le dimensioni massime dei pacchetti possono essere ottenute chiamando DeviceIoControl, specificando il codice di controllo di I /O IOCTL_GET_CHANNEL_ALIGN_RQST.

Requisiti

Vedi anche

IStiDevice::RawReadData

IStiUSD