ExInitializeRundownProtection-Funktion (wdm.h)
Der ExInitializeRundownProtection Routine initialisiert den Abwärtsschutz für ein freigegebenes Objekt.
Syntax
void ExInitializeRundownProtection(
[out] PEX_RUNDOWN_REF RunRef
);
Parameter
[out] RunRef
Ein Zeiger auf eine vom Aufrufer zugewiesene EX_RUNDOWN_REF Struktur, die initialisiert werden soll. Die Zuweisung muss auf 32-Bit-Plattformen ausgerichtet sein und 8-Byte auf 64-Bit-Plattformen ausgerichtet sein. Weitere Informationen finden Sie in den Hinweisen.
Rückgabewert
Nichts
Bemerkungen
Diese Routine wird vom Treiber aufgerufen, der ein Objekt besitzt, das sich im freigegebenen Speicher befindet und von anderen Treibern aufgerufen wird.
ExInitializeRundownProtection- muss aufgerufen werden, um eine EX_RUNDOWN_REF Struktur zu initialisieren, bevor sie als Parameter an eine andere Rundown-Schutzroutine übergeben wird.
Die Ausführungsschutzroutinen verwenden die EX_RUNDOWN_REF Struktur, um den Ausführungsstatus eines freigegebenen Objekts zu verfolgen, das der Struktur zugeordnet ist. Diese Statusinformationen enthalten eine Anzahl von Instanzen des Herunterlaufschutzes, die derzeit für das Objekt wirksam sind. ExInitializeRundownProtection initialisiert diese Anzahl auf Null.
Nachdem eine EX_RUNDOWN_REF Struktur initialisiert wurde, können andere Treiber, die auf das zugeordnete Objekt zugreifen, den ExAcquireRundownProtection- aufrufen und ExReleaseRundownProtection Routinen abrufen und freigeben, um den Rundownschutz für das Objekt abzurufen und freizugeben.
Weitere Informationen finden Sie unter Run-Down Protection.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows XP. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= APC_LEVEL |