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

Um método IStiUSD::RawReadData de um minidriver de imagem ainda lê dados de um dispositivo de imagem parada.

Sintaxe

HRESULT RawReadData(
  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

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 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

Um minidriver de imagem parada normalmente implementa esse método chamando ReadFile (descrito na documentação do SDK do Windows).

Para dispositivos USB, um melhor desempenho poderá ser obtido se as solicitações de leitura estiverem alinhadas aos limites máximos de tamanho do pacote. O máximo de tamanhos de pacote pode ser obtido chamando DeviceIoControl, especificando o código de controle de E/ S IOCTL_GET_CHANNEL_ALIGN_RQST .

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	stiusd.h (inclua Stiusd.h)

Confira também

IStiDevice::RawReadData

IStiUSD