ExRundownCompletedCacheAware function (wdm.h)

Article
02/26/2024

The ExRundownCompletedCacheAware routine updates the run-down status of a shared object to indicate that the run down of the object has completed.

Syntax

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

Parameters

[in, out] RunRefCacheAware

Pointer to the rundown protection object that the function will operate on. This is a pointer to an opaque EX_RUNDOWN_REF_CACHE_AWARE structure returned by a previous call to ExAllocateCacheAwareRundownProtection or ExInitializeRundownProtectionCacheAware.

Return value

None

Remarks

This routine is called by the driver that owns an object that resides in shared memory and that is accessed by other drivers. The ExRundownCompletedCacheAware call must be preceded by a call to the ExWaitForRundownProtectionReleaseCacheAware routine that runs down the object.

After an ExRundownCompletedCacheAware call, additional calls to ExWaitForRundownProtectionReleaseCacheAware to run down the associated object return immediately without waiting. However, calls to ExAcquireRundownProtectionCacheAware to acquire run-down protection on the associated object fail (return FALSE).

After an ExRundownCompletedCacheAware call, the driver can call the ExReInitializeRundownProtectionCacheAware routine to associate the EX_RUNDOWN_REF_CACHE_AWARE structure with a new object and to initialize run-down protection on this object. After the ExReInitializeRundownProtection call, drivers can call ExAcquireRundownProtectionCacheAware to acquire run-down protection on the new object.

On entry, the status information in the EX_RUNDOWN_REF_CACHE_AWARE structure must indicate that the object that was associated with this structure was run down.

Requirements

Requirement	Value
Minimum supported server	Windows Server 2003, Service Pack 1
Header	wdm.h (include Wdm.h)