ExReInitializeRundownProtectionCacheAware function (wdm.h)
The ExReInitializeRundownProtectionCacheAware routine reinitializes an EX_RUNDOWN_REF_CACHE_AWARE structure after the associated object is run down.
Syntax
void ExReInitializeRundownProtectionCacheAware(
[in, out] PEX_RUNDOWN_REF_CACHE_AWARE RunRefCacheAware
);
Parameters
[in, out] RunRefCacheAware
A pointer to a EX_RUNDOWN_REF_CACHE_AWARE structure that was initialized by a previous call to ExAllocateCacheAwareRundownProtection or ExInitializeRundownProtectionCacheAware. The cache-aware run-down protection routines use this structure to track the run-down status of the associated shared object. This structure is opaque to drivers.
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.
ExReInitializeRundownProtectionCacheAware enables a previously used EX_RUNDOWN_REF_CACHE_AWARE structure to be associated with a new object, and initializes cache-aware run-down protection on this object. After the ExReInitializeRundownProtectionCacheAware call, drivers can call ExAcquireRundownProtectionCacheAware to acquire cache-aware run-down protection on the new object.
An ExReInitializeRundownProtectionCacheAware call must be preceded by a call to the ExWaitForRundownProtectionReleaseCacheAware routine that runs down the old object. Between the ExWaitForRundownProtectionReleaseCacheAware and ExReInitializeRundownProtectionCacheAware calls, the driver might call the ExRundownCompletedCacheAware routine to indicate that the run down of the old object has completed.
On entry, the status information in the EX_RUNDOWN_REF_CACHE_AWARE structure must indicate that the old object was run down.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported server | Windows Server 2003, Service Pack 1 |
| Header | wdm.h (include Wdm.h) |
See also
Cache-aware run-down protection
ExAcquireRundownProtectionCacheAware
ExAcquireRundownProtectionCacheAwareEx
ExAllocateCacheAwareRundownProtection
ExFreeCacheAwareRundownProtection
ExInitializeRundownProtectionCacheAware
ExReleaseRundownProtectionCacheAware
ExReleaseRundownProtectionCacheAwareEx