Compartilhar via


EVT_WDF_IO_QUEUE_IO_DEFAULT função de retorno de chamada (wdfio.h)

[Aplica-se a KMDF e UMDF]

A função de retorno de chamada de evento EvtIoDefault de um driver processa uma solicitação de E/S especificada.

Sintaxe

EVT_WDF_IO_QUEUE_IO_DEFAULT EvtWdfIoQueueIoDefault;

void EvtWdfIoQueueIoDefault(
  [in] WDFQUEUE Queue,
  [in] WDFREQUEST Request
)
{...}

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.

Retornar valor

Nenhum

Comentários

Um driver registra uma função de retorno de chamada EvtIoDefault 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 EvtIoDefault para a fila de E/S de um dispositivo, a função de retorno de chamada receberá todas as solicitações de E/S da fila, a menos que as funções de retorno de chamada específicas da solicitação também tenham sido registradas. Para obter mais informações sobre funções de retorno de chamada específicas da solicitação, consulte Manipuladores de solicitação.

A função de retorno de chamada EvtIoDefault de um driver também pode receber solicitações de criação de arquivo. Para obter mais informações sobre como receber solicitações de criação de arquivo, consulte Objetos de Arquivo de Estrutura.

A função de retorno de chamada EvtIoDefault deve processar cada solicitação de E/S recebida de alguma maneira. Para obter mais informações, consulte Processando solicitações de E/S.

A maioria das operações de E/S exige um buffer de entrada, um buffer de saída ou ambos. Para obter informações sobre como o driver pode acessar os buffers de uma solicitação, 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 EvtIoDefault de um driver não deve chamar os seguintes métodos de objeto de fila:

WdfIoQueueDrainSynchronously
WdfIoQueuePurgeSynchronously
WdfIoQueueStopSynchronously

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)

Confira também

EvtIoDeviceControl

EvtIoInternalDeviceControl

EvtIoRead

EvtIoWrite

WDF_OBJECT_ATTRIBUTES

WdfIoQueueCreate