ExReInitializeRundownProtectionCacheAware-Funktion (wdm.h)

Artikel
02/27/2024

Die ExReInitializeRundownProtectionCacheAware-Routine initialisiert eine EX_RUNDOWN_REF_CACHE_AWARE Struktur neu, nachdem das zugeordnete Objekt heruntergefahren wurde.

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 ExInitializeRundownProtectionCacheAware initialisiert wurde. Die Cache-fähigen Herunterlaufschutzroutinen verwenden diese Struktur, um den heruntergefahrenen status des zugeordneten freigegebenen Objekts nachzuverfolgen. Diese Struktur ist für Treiber undurchsichtig.

Rückgabewert

Keine

Bemerkungen

Diese Routine wird vom Treiber aufgerufen, der ein Objekt besitzt, das sich im freigegebenen Arbeitsspeicher befindet und auf das andere Treiber zugreifen.

ExReInitializeRundownProtectionCacheAware ermöglicht es einer zuvor verwendeten EX_RUNDOWN_REF_CACHE_AWARE-Struktur , einem neuen Objekt zuzuordnen, und initialisiert cachebasierten Rundownschutz für dieses Objekt. Nach dem ExReInitializeRundownProtectionCacheAware-Aufruf können Treiber ExAcquireRundownProtectionCacheAware aufrufen, um cachebasierten Herunterlaufschutz für das neue Objekt zu erhalten.

Einem ExReInitializeRundownProtectionCacheAware-Aufruf muss ein Aufruf der ExWaitForRundownProtectionReleaseCacheAware-Routine vorangestellt sein, die das alte Objekt herunterläuft. 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.

Beim Eintrag muss die status Informationen in der EX_RUNDOWN_REF_CACHE_AWARE-Struktur angeben, dass das alte Objekt heruntergefahren wurde.