Função IofCompleteRequest (wdm.h)

A macro IoCompleteRequest indica que o chamador concluiu todo o processamento de uma determinada solicitação de E/S e está retornando o IRP especificado para o gerenciador de E/S.

IoCompleteRequest encapsula IofCompleteRequest.

Sintaxe

void IofCompleteRequest(
  PIRP  Irp,
  CCHAR PriorityBoost
);

Parâmetros

Irp

Ponteiro para o IRP a ser concluído.

PriorityBoost

Especifica uma constante CCHAR definida pelo sistema pela qual incrementar a prioridade de tempo de execução do thread original que solicitou a operação. Esse valor será IO_NO_INCREMENT se o thread original solicitou uma operação que o driver poderia concluir rapidamente (portanto, o thread solicitante não será compensado por sua espera presumida para que a E/S seja concluída) ou se o IRP for concluído com um erro. Caso contrário, o conjunto de constantes PriorityBoost é específico do tipo de dispositivo. Consulte Ntddk.h ou Wdm.h para obter essas constantes.

Retornar valor

Nenhum

Comentários

Quando um driver terminar todo o processamento de um determinado IRP, ele chamará IoCompleteRequest. O gerente de E/S verifica o IRP para determinar se algum driver de nível mais alto configurou uma rotina de IoCompletion para o IRP. Nesse caso, cada rotina IoCompletion é chamada, por sua vez, até que cada driver em camadas na cadeia conclua o IRP.

Quando todos os drivers tiverem concluído um determinado IRP, o gerente de E/S retornará status ao solicitante original da operação. Observe que um driver de nível superior que configura um IRP criado pelo driver deve fornecer uma rotina IoCompletion para liberar o IRP que ele criou.

Nunca chame IoCompleteRequest enquanto mantém um bloqueio de rotação. Tentar concluir um IRP enquanto mantém um bloqueio de rotação pode causar deadlocks.

Requisitos

Confira também

IoSetCompletionRoutine