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 usano 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 a ExRundownCompleted deve essere preceduta da una chiamata alla routine ExWaitForRundownProtectionRelease che esegue l'oggetto.
Dopo una chiamata a ExRundownCompleted , chiamate aggiuntive a ExWaitForRundownProtectionRelease per eseguire immediatamente l'oggetto associato vengono restituite immediatamente senza attendere. Tuttavia, le chiamate a ExAcquireRundownProtection per acquisire la protezione di run-down sull'oggetto associato hanno esito negativo (restituiscono FALSE).
Dopo una chiamata a ExRundownCompleted , il driver può chiamare la routine ExReInitializeRundownProtection per associare la struttura EX_RUNDOWN_REF a un nuovo oggetto e inizializzare la protezione di run-down per questo oggetto. Dopo la chiamata a 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.For more information, see Run-Down Protection.
Requisiti
| 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 |