EVT_WDF_IO_QUEUE_IO_READ função de retorno de chamada (wdfio.h)
[Aplica-se a KMDF e UMDF]
A função de retorno de chamada de evento EvtIoRead de um driver processa uma solicitação de leitura especificada.
Sintaxe
EVT_WDF_IO_QUEUE_IO_READ EvtWdfIoQueueIoRead;
void EvtWdfIoQueueIoRead(
[in] WDFQUEUE Queue,
[in] WDFREQUEST Request,
[in] size_t Length
)
{...}
Parâmetros
[in] Queue
Um identificador para o objeto de fila de estrutura associado à solicitação de E/S.
[in] Request
Um identificador para um objeto de solicitação de estrutura.
[in] Length
O número de bytes a serem lidos.
Retornar valor
Nenhum
Comentários
Um driver registra uma função de retorno de chamada EvtIoRead quando chama WdfIoQueueCreate. Para obter mais informações sobre como chamar WdfIoQueueCreate, consulte Criando filas de E/S.
Se um driver tiver registrado uma função de retorno de chamada EvtIoRead para a fila de E/S de um dispositivo, a função de retorno de chamada receberá cada solicitação de leitura da fila. Para obter mais informações, consulte Manipuladores de solicitação.
A função de retorno de chamada EvtIoRead deve processar cada solicitação de E/S recebida de alguma maneira. Para obter mais informações, consulte Processando solicitações de E/S.
As solicitações de leitura exigem um buffer de saída, que recebe dados fornecidos pelo driver. Para obter informações sobre como o driver pode acessar o buffer de uma solicitação de leitura, consulte Acessando buffers de dados em drivers de Framework-Based.
Essa função de retorno de chamada pode ser chamada em IRQL <= DISPATCH_LEVEL, a menos que o membro ExecutionLevel da estrutura de WDF_OBJECT_ATTRIBUTES do dispositivo ou do driver seja definido como WdfExecutionLevelPassive.
Se o IRQL for PASSIVE_LEVEL, a estrutura chamará a função de retorno de chamada dentro de uma região crítica.
Para obter mais informações sobre os níveis de IRQL para manipuladores de solicitação, consulte Usando a sincronização automática.
A função de retorno de chamada EvtIoRead de um driver não deve chamar os seguintes métodos de objeto de fila:
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Versão mínima do UMDF | 2,0 |
| Cabeçalho | wdfio.h (inclua Wdf.h) |
| IRQL | <= DISPATCH_LEVEL (consulte a seção Comentários) |