ExInitializeRundownProtection-Funktion (wdm.h)
Die ExInitializeRundownProtection-Routine initialisiert den Rundown-Schutz für ein freigegebenes Objekt.
Syntax
void ExInitializeRundownProtection(
[out] PEX_RUNDOWN_REF RunRef
);
Parameter
[out] RunRef
Ein Zeiger auf eine vom Aufrufer zugeordnete EX_RUNDOWN_REF Struktur, die initialisiert werden soll. Die Zuordnung muss 4 Byte auf 32-Bit-Plattformen ausgerichtet und 8 Byte auf 64-Bit-Plattformen ausgerichtet sein. Weitere Informationen finden Sie in den Hinweisen.
Rückgabewert
Keine
Bemerkungen
Diese Routine wird von dem Treiber aufgerufen, der ein Objekt besitzt, das sich im freigegebenen Speicher befindet und auf das andere Treiber zugreifen.
ExInitializeRundownProtection muss aufgerufen werden, um eine EX_RUNDOWN_REF-Struktur zu initialisieren, bevor sie als Parameter an eine andere Herunterlaufschutzroutine übergeben wird.
Die Rundownschutzroutinen verwenden die EX_RUNDOWN_REF-Struktur, um die ausgeführte status eines freigegebenen Objekts zu verfolgen, das der Struktur zugeordnet ist. Diese status Informationen umfassen die Anzahl der Instanzen des Rundown-Schutzes, 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, die Routinen ExAcquireRundownProtection und ExReleaseRundownProtection aufrufen, um run-down-Schutz für das Objekt abzurufen und freizugeben.
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 |