Metodo IStiDevice::RawWriteCommand (sti.h)

Articolo
02/07/2025

Il metodo IStiDevice::RawWriteCommand invia informazioni sul comando 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 i dati da inviare al dispositivo.

nNumberOfBytes

Numero di byte fornito dal chiamante da scrivere. Numero di byte nel buffer a cui punta lpBuffer.

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

Osservazioni

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

È necessario chiamare solo IStiDevice::RawWriteCommand se i comandi e i dati vengono scritti in un dispositivo con metodi diversi. Per altri dispositivi, è possibile usare IStiDevice::RawWriteData sia per i comandi che per i dati.

Prima di chiamare IStiDevice::RawWriteCommand, i client dell'interfaccia IStiDevice COM devono chiamare IStillImage::CreateDevice per ottenere un puntatore di 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.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	sti.h (include Sti.h)

Condividi tramite