Funzione IoMarkIrpPending (wdm.h)
La routine IoMarkIrpPending contrassegna l'IRP specificato, indicando che la routine di invio di un driver ha restituito successivamente STATUS_PENDING perché è richiesta un'ulteriore elaborazione da altre routine del driver.
Sintassi
void IoMarkIrpPending(
[in, out] PIRP Irp
);
Parametri
[in, out] Irp
Puntatore all'IRP da contrassegnare come in sospeso.
Valore restituito
nessuno
Osservazioni
A meno che la routine dispatch del driver non completi l'IRP (chiamando IoCompleteRequest) o passi l'IRP ai driver inferiori, deve chiamare IoMarkIrpPending con l'IRP. In caso contrario, il gestore di I/O tenta di completare l'IRP non appena la routine dispatch restituisce il controllo .
Dopo aver chiamato IoMarkIrpPending, la routine dispatch deve restituire STATUS_PENDING, anche se alcune routine completano l'IRP (chiamando IoCompleteRequest) prima che la routine dispatch denominata IoMarkIrpPending restituisca.
Se un driver accoda i runtime di integrazione in ingresso, deve chiamare IoMarkIrpPending prima di accodare ogni IRP. In caso contrario, un IRP potrebbe essere dequeued, completato da un'altra routine del driver e liberato dal sistema prima che si verifichi la chiamata a IoMarkIrpPending , causando così un arresto anomalo.
Se un driver imposta una routine IoCompletion per un IRP e quindi passa l'IRP a un driver inferiore, la routine IoCompletion deve controllare il flag IRP-PendingReturned>. Se il flag è impostato, la routine IoCompletion deve chiamare IoMarkIrpPending con IRP. Le routine IoCompletion non restituiscono STATUS_PENDING. Per altre informazioni, vedere Implementazione di una routine IoCompletion.
I driver che creano l'IRP e lo inviano a un altro stack non devono chiamare IoMarkIrpPending nella routine di completamento. Questa chiamata danneggia l'intestazione del pool dell'allocazione successiva perché non esiste alcuna posizione dello stack per tali driver.
Un driver che passa l'IRP e quindi attende un evento non deve contrassegnare l'IRP in sospeso. Al contrario, la routine IoCompletion deve segnalare l'evento e restituire STATUS_MORE_PROCESSING_REQUIRED.
Se il driver chiama IoSkipCurrentIrpStackLocation, prestare attenzione a non modificare la struttura IO_STACK_LOCATION in modo che possa influire involontariamente sul driver inferiore o sul comportamento del sistema rispetto a tale driver. In particolare, il driver non deve modificare l'unione dei parametri della struttura IO_STACK_LOCATION e non deve chiamare IoMarkIrpPending.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | Qualsiasi livello |
| Regole di conformità DDI | CompleteRequestStatusCheck(wdm), CompletionEventChecking(wdm), IrpCancelField(wdm), LowerDriverReturn(wdm), MarkDevicePower(wdm), MarkingInterlockedQueuedIrps(wdm), MarkingQueuedIrps(wdm), MarkIrpPending(wdm), MarkIrpPending2(wdm), MarkPower(wdm), MarkPowerDown(wdm), MarkQueryRelations(wdm), MarkStartDevice(wdm), PendedCompletedRequest3(wdm) |