Metodo IStiUSD::RawReadData (stiusd.h)
Il metodo IStiUSD::RawReadData di un minidriver dell'immagine continua legge i dati da un dispositivo ancora immagine.
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 un 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 fornito dal chiamante facoltativo 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 con prefisso STIERR definiti in stierr.h.
Osservazioni
Un minidriver di immagini 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. È possibile ottenere dimensioni massime dei pacchetti chiamando DeviceIoControl, specificando il codice di controllo I/O IOCTL_GET_CHANNEL_ALIGN_RQST.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | stiusd.h (include Stiusd.h) |