Metodo IStiUSD::RawReadCommand (stiusd.h)

Il metodo IStiUSD::RawReadCommand di un'immagine continua legge le informazioni sui comandi da un dispositivo immagine ancora.

Sintassi

HRESULT RawReadCommand(
  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

È necessario implementare solo IStiUSD::RawReadCommand se i comandi e le informazioni sui dati vengono letti da un dispositivo in base a metodi diversi. Per altri dispositivi, È possibile usare IStiUSD::RawReadData per i comandi e i dati. Se la chiamata non viene implementata, deve restituire STIERR_UNSUPPORTED.

L'implementazione di questo metodo, insieme al significato del contenuto del buffer, è definita dal fornitore.

Requisiti

Vedi anche

IStiDevice::RawReadCommand

IStiUSD