Método IStiUSD::RawReadData (stiusd.h)
O método IStiUSD::RawReadData de um minidriver de imagem ainda lê dados de um dispositivo de imagem morta.
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
Ponteiro opcional fornecido pelo chamador para uma estrutura OVERLAPPED (descrito na documentação do SDK do Microsoft Windows).
Valor de retorno
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.
Observações
Um minidriver de imagem morta 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. Tamanhos máximos de pacote podem ser obtidos chamando DeviceIoControl, especificando o código de controle de E/S IOCTL_GET_CHANNEL_ALIGN_RQST.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | stiusd.h (inclua Stiusd.h) |