EVT_WDF_IO_ALLOCATE_REQUEST_RESOURCES função de retorno de chamada (wdfio.h)
[Aplica-se somente ao KMDF]
A função de retorno de chamada EvtIoAllocateRequestResources de um driver aloca recursos específicos da solicitação que o driver requer para processar a solicitação especificada.
Sintaxe
EVT_WDF_IO_ALLOCATE_REQUEST_RESOURCES EvtWdfIoAllocateRequestResources;
NTSTATUS EvtWdfIoAllocateRequestResources(
[in] WDFQUEUE Queue,
[in] WDFREQUEST Request
)
{...}
Parâmetros
[in] Queue
Um identificador para um objeto de fila de E/S.
[in] Request
Um identificador para um objeto de solicitação que a estrutura criou. A estrutura ainda não adicionou o objeto de solicitação à fila de E/S especificada pelo identificador do parâmetro Queue .
Retornar valor
A função de retorno de chamada EvtIoAllocateRequestResources deve retornar STATUS_SUCCESS ou outro valor status para o qual NT_SUCCESS(status) é igual a TRUE se a função não encontrar erros. Caso contrário, essa função deve retornar um valor status para o qual NT_SUCCESS(status) é igual a FALSE.
Comentários
Um driver pode registrar uma função de retorno de chamada EvtIoAllocateRequestResources quando chama WdfIoQueueAssignForwardProgressPolicy.
Se o driver registrar uma função de retorno de chamada EvtIoAllocateRequestResources , a estrutura chamará a função imediatamente depois de criar um objeto de solicitação para um IRP (pacote de solicitação de E/S) que o gerenciador de E/S enviou ao driver.
A função de retorno de chamada pode alocar recursos que o driver precisará para processar a solicitação posteriormente, depois que o driver tiver obtido o objeto de solicitação da fila de E/S especificada pelo identificador do parâmetro Queue .
Se a função de retorno de chamada alocar recursos com êxito e retornar STATUS_SUCCESS, a estrutura eventualmente entregará o objeto de solicitação ao driver.
Se ocorrer um erro de alocação de recurso, como uma situação de memória insuficiente, a função de retorno de chamada deverá retornar um erro status valor. Nesse caso, a estrutura segue a política de progresso do driver, que o driver especificou anteriormente com um valor WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY quando chamou WdfIoQueueAssignForwardProgressPolicy.
Para obter mais informações sobre a função de retorno de chamada EvtIoAllocateRequestResources , consulte Garantindo o progresso das operações de E/S.
Essa função de retorno de chamada pode ser chamada em IRQL <= DISPATCH_LEVEL. Se o IRQL for PASSIVE_LEVEL, a estrutura chamará a função de retorno de chamada em uma região crítica.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1,9 |
| Cabeçalho | wdfio.h (inclua Wdf.h) |
| IRQL | <=DISPATCH_LEVEL (consulte a seção Comentários) |