Método IStiDevice::RawWriteCommand (sti.h)

O método IStiDevice::RawWriteCommand envia informações de comando para um dispositivo de imagem parada.

Sintaxe

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

Parâmetros

[in] lpBuffer

Ponteiro fornecido pelo chamador para um buffer que contém dados a serem enviados para o dispositivo.

nNumberOfBytes

Número de bytes fornecidos pelo chamador a serem gravados. Esse é o número de bytes no buffer apontado por lpBuffer.

[in, optional] lpOverlapped

Ponteiro opcional fornecido pelo chamador para uma estrutura OVERLAPPED (descrito na documentação do SDK do Microsoft Windows).

Retornar valor

Se a operação for bem-sucedida, o método retornará S_OK. Caso contrário, ele retornará um dos códigos de erro prefixados por STIERR definidos em stierr.h.

Comentários

O método IStiDevice::RawWriteCommand chama IStiUSD::RawWriteCommand, que é exportado por minidrivers fornecidos pelo fornecedor. O significado do conteúdo do buffer é definido pelo fornecedor.

Só é necessário chamar IStiDevice::RawWriteCommand se comandos e dados forem gravados em um dispositivo por métodos diferentes. Para outros dispositivos, IStiDevice::RawWriteData pode ser usado para comandos e dados.

Antes de chamar IStiDevice::RawWriteCommand, os clientes da interface COM IStiDevice devem chamar IStillImage::CreateDevice para obter um ponteiro de interface IStiDevice , que fornece acesso a um dispositivo especificado.

Uma chamada para IStiDevice::RawWriteCommand deve ser precedida por uma chamada para IStiDevice::LockDevice e seguida por uma chamada para IStiDevice::UnLockDevice.

Requisitos