Metodo IStiDevice::RawWriteCommand (sti.h)

Il metodo IStiDevice::RawWriteCommand invia informazioni sui comandi a un dispositivo ancora immagine.

Sintassi

HRESULT RawWriteCommand(
  [in]           LPVOID       lpBuffer,
                 DWORD        nNumberOfBytes,
  [in, optional] LPOVERLAPPED lpOverlapped
);

Parametri

[in] lpBuffer

Puntatore fornito dal chiamante a un buffer contenente dati da inviare al dispositivo.

nNumberOfBytes

Numero di byte fornito dal chiamante da scrivere. Si tratta del numero di byte nel buffer a cui punta lpBuffer.

[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::RawWriteCommand chiama IStiUSD::RawWriteCommand, esportato dai minidriver forniti dal fornitore. Il significato del contenuto del buffer è definito dal fornitore.

È necessario solo chiamare IStiDevice::RawWriteCommand se i comandi e i dati vengono scritti in un dispositivo in base a metodi diversi. Per altri dispositivi, IStiDevice::RawWriteData può essere usato sia per i comandi che per i dati.

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

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

Requisiti