Funzione ExRundownCompleted (wdm.h)
La routine ExRundownCompleted aggiorna lo stato di esecuzione di un oggetto condiviso per indicare che l'esecuzione dell'oggetto è stata completata.
Sintassi
void ExRundownCompleted(
[out] PEX_RUNDOWN_REF RunRef
);
Parametri
[out] RunRef
Puntatore a una struttura EX_RUNDOWN_REF inizializzata da una chiamata precedente alla routine ExInitializeRundownProtection. Le routine di protezione di run-down utilizzano questa struttura per tenere traccia dello stato di esecuzione dell'oggetto condiviso associato. Questa struttura è opaca per i driver.
Valore restituito
Nessuno
Osservazioni
Questa routine viene chiamata dal driver proprietario di un oggetto che risiede nella memoria condivisa e accessibile da altri driver. La chiamata exRundownCompleted deve essere preceduta da una chiamata al ExWaitForRundownProtectionRelease routine che esegue l'oggetto.
Dopo una chiamata exRundownCompleted, chiamate aggiuntive a ExWaitForRundownProtectionRelease per eseguire immediatamente l'oggetto associato senza attendere. Tuttavia, le chiamate a ExAcquireRundownProtection per acquisire la protezione di run-down nell'oggetto associato hanno esito negativo (restituire FALSE).
Dopo una chiamata exRundownCompleted, il driver può chiamare la routine ExReInitializeRundownProtection per associare la struttura EX_RUNDOWN_REF a un nuovo oggetto e per inizializzare la protezione di esecuzione su questo oggetto. Dopo la chiamata exReInitializeRundownProtection, i driver possono chiamare ExAcquireRundownProtection per acquisire la protezione di run-down sul nuovo oggetto.
In caso di immissione, le informazioni sullo stato nella struttura EX_RUNDOWN_REF devono indicare che l'oggetto associato a questa struttura è stato eseguito inattivo.
Per altre informazioni, vedere Run-Down Protection.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows XP. |
| piattaforma di destinazione | Universale |
| intestazione | wdm.h (include Wdm.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |