EVT_WDF_IO_QUEUE_IO_INTERNAL_DEVICE_CONTROL função de retorno de chamada (wdfio.h)
[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:
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) |