ExRundownCompleted-Funktion (wdm.h)
Die ExRundownCompleted-Routine aktualisiert die ausführungsbasierte status eines freigegebenen Objekts, um anzugeben, dass die Ausführung des Objekts abgeschlossen ist.
Syntax
void ExRundownCompleted(
[out] PEX_RUNDOWN_REF RunRef
);
Parameter
[out] RunRef
Ein Zeiger auf eine EX_RUNDOWN_REF Struktur, die durch einen vorherigen Aufruf der ExInitializeRundownProtection-Routine initialisiert wurde. Die Rundownschutzroutinen verwenden diese Struktur, um die ausgeführte status des zugeordneten freigegebenen Objekts nachzuverfolgen. Diese Struktur ist für Treiber undurchsichtig.
Rückgabewert
Keine
Bemerkungen
Diese Routine wird von dem Treiber aufgerufen, der ein Objekt besitzt, das sich im freigegebenen Speicher befindet und auf das von anderen Treibern zugegriffen wird. Dem ExRundownCompleted-Aufruf muss ein Aufruf der ExWaitForRundownProtectionRelease-Routine vorangestellt werden, die das -Objekt herunterläuft.
Nach einem ExRundownCompleted-Aufruf werden zusätzliche Aufrufe von ExWaitForRundownProtectionRelease zum Ausführen des zugeordneten Objekts sofort ohne Wartezeit zurückgegeben. Aufrufe von ExAcquireRundownProtection zum Abrufen des Rundown-Schutzes für das zugeordnete Objekt schlagen jedoch fehl ( geben FALSE zurück).
Nach einem ExRundownCompleted-Aufruf kann der Treiber die ExReInitializeRundownProtection-Routine aufrufen, um die EX_RUNDOWN_REF-Struktur einem neuen Objekt zuzuordnen und den Rundownschutz für dieses Objekt zu initialisieren. Nach dem ExReInitializeRundownProtection-Aufruf können Treiber ExAcquireRundownProtection aufrufen, um run-down-Schutz für das neue Objekt zu erhalten.
Beim Eintrag müssen die status Informationen in der EX_RUNDOWN_REF-Struktur angeben, dass das dieser Struktur zugeordnete Objekt heruntergefahren wurde.
Weitere Informationen finden Sie unter Run-Down Protection.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows XP. |
| Zielplattform | Universell |
| Header | wdm.h (wdm.h einschließen) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |