Metodo IStiDevice::RawReadCommand (sti.h)

Il metodo IStiDevice::RawReadCommand legge le informazioni sui comandi da un dispositivo ancora immagine.

Sintassi

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

Parametri

[in, out] lpBuffer

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

[in, out] lpdwNumberOfBytes

Puntatore fornito dal chiamante a una DWORD. Il chiamante deve caricare DWORD con il numero di byte nel buffer a cui punta lpBuffer. Al ritorno, conterrà il numero di byte effettivamente letti.

[in, optional] 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 restituisce S_OK. In caso contrario, restituisce uno dei codici di errore con prefisso STIERR definiti in stierr.h.

Commenti

Il metodo IStiDevice::RawReadCommand chiama IStiUSD::RawReadCommand, esportato dai minidriver forniti dal fornitore. Il significato del contenuto del buffer è definito dal fornitore.

È necessario solo chiamare IStiDevice::RawReadCommand se i comandi e le informazioni sui dati vengono letti da un dispositivo in base a metodi diversi. Per altri dispositivi, IStiDevice::RawReadData può essere usato sia per i comandi che per i dati.

Prima di chiamare IStiDevice::RawReadCommand, i client dell'interfaccia COMIStiDevice devono chiamare IStillImage::CreateDevice per ottenere un puntatore dell'interfaccia IStiDevice, che fornisce l'accesso a un dispositivo specificato.

Una chiamata a IStiDevice::RawReadCommand deve essere preceduta da una chiamata a IStiDevice::LockDevice e seguita da una chiamata a IStiDevice::UnLockDevice.

Requisiti