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