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

O método IStiDevice::RawReadCommand lê informações de comando de um dispositivo de imagem parada.

Sintaxe

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

Parâmetros

[in, out] lpBuffer

Ponteiro fornecido pelo chamador para um buffer para receber dados lidos do dispositivo.

[in, out] lpdwNumberOfBytes

Ponteiro fornecido pelo chamador para um DWORD. O chamador deve carregar o DWORD com o número de bytes no buffer apontado por lpBuffer. No retorno, ele conterá o número de bytes realmente lidos.

[in, optional] lpOverlapped

Opcional, ponteiro 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::RawReadCommand chama IStiUSD::RawReadCommand, que é exportado por minidrivers fornecidos pelo fornecedor. O significado do conteúdo do buffer é definido pelo fornecedor.

Só é necessário chamar IStiDevice::RawReadCommand se as informações de comando e dados forem lidas de um dispositivo por métodos diferentes. Para outros dispositivos, IStiDevice::RawReadData pode ser usado para comandos e dados.

Antes de chamar IStiDevice::RawReadCommand, 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::RawReadCommand deve ser precedida por uma chamada para IStiDevice::LockDevice e seguida por uma chamada para IStiDevice::UnLockDevice.

Requisitos