Método IStiUSD::RawReadCommand (stiusd.h)

Um método IStiUSD::RawReadCommand de um minidriver de imagem ainda lê informações de comando de um dispositivo de imagem parada.

Sintaxe

HRESULT RawReadCommand(
  LPVOID       lpBuffer,
  LPDWORD      lpdwNumberOfBytes,
  LPOVERLAPPED lpOverlapped
);

Parâmetros

lpBuffer

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

lpdwNumberOfBytes

Ponteiro fornecido pelo chamador para um DWORD. O chamador carrega o DWORD com o número de bytes no buffer apontado por lpBuffer. O driver deve substituir esse valor pelo número de bytes realmente lidos.

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 deverá retornar S_OK. Caso contrário, ele deverá retornar um dos códigos de erro prefixados por STIERR definidos em stierr.h.

Comentários

Só é necessário implementar IStiUSD::RawReadCommand se as informações de comando e dados forem lidas de um dispositivo por métodos diferentes. Para outros dispositivos, IStiUSD::RawReadData pode ser usado para comandos e dados. Se a chamada não for implementada, ela deverá retornar STIERR_UNSUPPORTED.

A implementação desse método, juntamente com o significado do conteúdo do buffer, é definida pelo fornecedor.

Requisitos

Confira também

IStiDevice::RawReadCommand

IStiUSD