ExAcquireRundownProtectionEx-Funktion (wdm.h)
Die ExAcquireRundownProtectionEx-Routine versucht, run-down-Schutz für ein freigegebenes Objekt zu erhalten, damit der Aufrufer sicher auf das Objekt zugreifen kann.
Syntax
BOOLEAN ExAcquireRundownProtectionEx(
[in, out] PEX_RUNDOWN_REF RunRef,
[in] ULONG Count
);
Parameter
[in, 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.
[in] Count
Der Betrag, um den der Rundown instance Anzahl des Objekts erhöht werden soll. Die Anzahl wird nur erhöht, wenn die Routine TRUE zurückgibt. Weitere Informationen finden Sie unter Hinweise.
Rückgabewert
ExAcquireRundownProtectionEx gibt TRUE zurück, wenn die Routine erfolgreich einen Rundownschutz für den Aufrufer erhält. Andernfalls wird FALSE zurückgegeben. Der Rückgabewert FALSE gibt an, dass die Ausführung des Objekts gestartet wurde und dass das Objekt als ungültig behandelt werden muss.
Hinweise
Um sicher auf ein freigegebenes Objekt zuzugreifen, ruft ein Treiber ExAcquireRundownProtectionEx auf, um run-down-Schutz für das Objekt zu erhalten.
Der RunRef-Parameter verweist auf eine EX_RUNDOWN_REF-Struktur, die die ausgeführte status des zugeordneten Objekts nachverfolgt. Diese status Informationen umfassen die Anzahl der Instanzen des Rundown-Schutzes, die derzeit für das Objekt wirksam sind. Die Routinen ExAcquireRundownProtectionEx und ExReleaseRundownProtectionEx erhöhen und verringern diese Anzahl um beliebige Mengen. Zwei verwandte Routinen, ExAcquireRundownProtection und ExReleaseRundownProtection, erhöhen und verringern diese Anzahl um eins.
Solange der run-down-Block selbst nicht aus der Seite ist, kann diese Funktion bei DISPATCH_LEVEL aufgerufen werden.
Weitere Informationen finden Sie unter Run-Down Protection.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows Server 2003. |
| Zielplattform | Universell |
| Header | wdm.h (wdm.h einschließen) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL (siehe Hinweise) |
| DDI-Complianceregeln | HwStorPortProhibitedDIs(storport) |