EVT_WDF_IO_QUEUE_IO_WRITE função de retorno de chamada (wdfio.h)
[Aplica-se a KMDF e UMDF]
A função de retorno de chamada de evento EvtIoWrite do driver processa uma solicitação de gravação especificada.
Sintaxe
EVT_WDF_IO_QUEUE_IO_WRITE EvtWdfIoQueueIoWrite;
void EvtWdfIoQueueIoWrite(
[in] WDFQUEUE Queue,
[in] WDFREQUEST Request,
[in] size_t Length
)
{...}
Parâmetros
[in] Queue
Um identificador para o objeto de fila da 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 gravados.
Valor de retorno
Nenhum
Observações
Um driver registra uma função de retorno de chamada EvtIoWrite quando chama WdfIoQueueCreate. Para obter mais informações sobre como chamar WdfIoQueueCreate, consulte Criando filas de E/S.
Se um driver tiver registrado um EvtIoWrite função de retorno de chamada para a fila de E/S de um dispositivo, a função de retorno de chamada receberá todas as solicitações de gravação da fila. Para obter mais informações, consulte Manipuladores de Solicitações.
A função de retorno de chamada EvtIoWrite deve processar cada solicitação de E/S recebida de alguma forma. Para obter mais informações, consulte processamento de solicitações de E/S.
As solicitações de gravação exigem um buffer de entrada, que contém dados recebidos pelo driver. Para obter informações sobre como o driver pode acessar o buffer de uma solicitação de gravação, consulte Acessando buffers de dados em Framework-Based Drivers.
Essa função de retorno de chamada pode ser chamada em IRQL <= DISPATCH_LEVEL, a menos que o ExecutionLevel membro da estrutura de WDF_OBJECT_ATTRIBUTES do dispositivo ou do driver esteja definido como WdfExecutionLevelPassive.
Se o IRQL for PASSIVE_LEVEL, a estrutura chamará a função de retorno de chamada em uma região crítica .
Para obter mais informações sobre os níveis de IRQL para manipuladores de solicitação, consulte Usandode Sincronização Automática.
A função de retorno de chamada EvtIoWrite de um driver não deve chamar os seguintes métodos de objeto de fila:
Requisitos
| Requisito | Valor |
|---|---|
| da 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) |