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

  • Artigo

[Aplica-se a KMDF e UMDF]

A função de retorno de chamada de evento EvtIoInternalDeviceControl de um driver processa uma solicitação de E/S que contém um IOCTL (código de controle de E/S) interno do dispositivo.

Sintaxe

EVT_WDF_IO_QUEUE_IO_INTERNAL_DEVICE_CONTROL EvtWdfIoQueueIoInternalDeviceControl;

void EvtWdfIoQueueIoInternalDeviceControl(
  [in] WDFQUEUE Queue,
  [in] WDFREQUEST Request,
  [in] size_t OutputBufferLength,
  [in] size_t InputBufferLength,
  [in] ULONG IoControlCode
)
{...}

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] OutputBufferLength

O comprimento, em bytes, do buffer de saída da solicitação, se um buffer de saída estiver disponível.

[in] InputBufferLength

O comprimento, em bytes, do buffer de entrada da solicitação, se um buffer de entrada estiver disponível.

[in] IoControlCode

O IOCTL definido pelo driver ou definido pelo sistema associado à solicitação.

Retornar valor

Nenhum

Comentários

Um driver registra uma função de retorno de chamada EvtIoInternalDeviceControl quando chama o método 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 EvtIoInternalDeviceControl para a fila de E/S de um dispositivo, a função de retorno de chamada receberá todas as solicitações internas de controle de E/S (IRP_MJ_INTERNAL_DEVICE_CONTROL) da fila. Para obter mais informações, consulte Manipuladores de solicitação.

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

Os drivers recebem solicitações de controle de E/S internas quando outro driver cria uma solicitação chamando WdfIoTargetSendInternalIoctlSynchronously ou WdfIoTargetFormatRequestForInternalIoctl.

O tipo de operação a ser executada depende do valor do parâmetro IoControlCode . Você deve determinar o conjunto de valores IoControlCode que os aplicativos e outros drivers podem enviar para o driver. Para obter mais informações sobre IOCTLs, consulte Usando códigos de controle de E/S.

A maioria das operações de controle de E/S internas 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.

As técnicas que o driver pode usar para acessar os buffers de entrada e saída da solicitação (se existirem) dependem do campo TransferType do IOCTL. O valor do campo TransferType do IOCTL pode ser METHOD_BUFFERED, METHOD_DIRECT_IN, METHOD_DIRECT_OUT ou METHOD_NEITHER. Para obter mais informações sobre o campo TransferType , consulte Definindo códigos de controle de E/S.

A função de retorno de chamada EvtIoInternalDeviceControl 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 driver estiver na parte superior da pilha de driver, a função de retorno de chamada será chamada em IRQL = PASSIVE_LEVEL.)

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

WDF_OBJECT_ATTRIBUTES

WdfIoQueueCreate

WdfIoTargetFormatRequestForInternalIoctl

WdfIoTargetSendInternalIoctlSynchronously