ExReInitializeRundownProtectionCacheAware-Funktion (wdm.h)

Artikel
02/07/2025

Die ExReInitializeRundownProtectionCacheAware Routine eine EX_RUNDOWN_REF_CACHE_AWARE Struktur neu initialisiert, nachdem das zugeordnete Objekt ausgeführt wird.

Syntax

void ExReInitializeRundownProtectionCacheAware(
  [in, out] PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware
);

Parameter

[in, out] RunRefCacheAware

Ein Zeiger auf eine EX_RUNDOWN_REF_CACHE_AWARE Struktur, die durch einen vorherigen Aufruf von ExAllocateCacheAwareRundownProtection oder ExInitializeRundownProtectionCacheAwareinitialisiert wurde. Die cachefähigen Ausführungsschutzroutinen verwenden diese Struktur, um den Ausführungsstatus des zugeordneten freigegebenen Objekts nachzuverfolgen. Diese Struktur ist für Treiber nicht transparent.

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.

ExReInitializeRundownProtectionCacheAware ermöglicht es einer zuvor verwendeten EX_RUNDOWN_REF_CACHE_AWARE Struktur, einem neuen Objekt zugeordnet zu werden, und initialisiert den Cache-fähigen Run-Down-Schutz für dieses Objekt. Nachdem der ExReInitializeRundownProtectionCacheAware Aufruf aufgerufen wurde, können Treiber ExAcquireRundownProtectionCacheAware- aufrufen, um den cachefähigen Run-down-Schutz für das neue Objekt abzurufen.

Einem ExReInitializeRundownProtectionCacheAware Aufruf muss ein Aufruf der ExWaitForRundownProtectionReleaseCacheAware Routine vorausgehen, die das alte Objekt ausführt. Zwischen den aufrufen ExWaitForRundownProtectionReleaseCacheAware und ExReInitializeRundownProtectionCacheAware ruft der Treiber möglicherweise die ExRundownCompletedCacheAware Routine auf, um anzugeben, dass die Ausführung des alten Objekts abgeschlossen ist.

Bei der Eingabe müssen die Statusinformationen in der EX_RUNDOWN_REF_CACHE_AWARE-Struktur angeben, dass das alte Objekt ausgeführt wurde.