Funzione IofCompleteRequest (wdm.h)

La macro IoCompleteRequest indica che il chiamante ha completato tutte le elaborazioni per una determinata richiesta di I/O e restituisce l'IRP specificato al gestore di I/O.

IoCompleteRequest esegue il wrapping di IofCompleteRequest.

Sintassi

void IofCompleteRequest(
  PIRP  Irp,
  CCHAR PriorityBoost
);

Parametri

Irp

Puntatore all'IRP da completare.

PriorityBoost

Specifica una costante CCHAR definita dal sistema in base alla quale incrementare la priorità di runtime del thread originale che ha richiesto l'operazione. Questo valore è IO_NO_INCREMENT se il thread originale ha richiesto un'operazione che il driver potrebbe completare rapidamente (quindi il thread richiedente non viene compensato per l'attesa presunta del completamento dell'I/O) o se l'IRP viene completato con un errore. In caso contrario, il set di costanti PriorityBoost è specifico del tipo di dispositivo. Per queste costanti, vedere Ntddk.h o Wdm.h.

Valore restituito

nessuno

Osservazioni

Al termine di tutta l'elaborazione per un determinato provider di risorse IRP, un driver chiama IoCompleteRequest. Il gestore di I/O controlla l'IRP per determinare se i driver di livello superiore hanno configurato una routine IoCompletion per IRP. In tal caso, ogni routine IoCompletion viene chiamata, a sua volta, fino a quando ogni driver a più livelli nella catena non ha completato l'IRP.

Quando tutti i driver hanno completato un determinato IRP, il gestore di I/O restituisce lo stato al richiedente originale dell'operazione. Si noti che un driver di livello superiore che configura un IRP creato dal driver deve fornire una routine IoCompletion per rilasciare l'IRP creato.

Non chiamare mai IoCompleteRequest tenendo premuto un blocco di rotazione. Il tentativo di completare un IRP tenendo premuto un blocco spin può causare deadlock.

Requisiti

Vedi anche

IoSetCompletionRoutine