ExReInitializeRundownProtection - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// wdm.h

VOID ExReInitializeRundownProtection(
  [in, out] PEX_RUNDOWN_REF RunRef
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-wdm-exreinitializerundownprotection)

ExReInitializeRundownProtection function

Description

The ExReInitializeRundownProtection routine reinitializes an EX_RUNDOWN_REF structure after the associated object is run down.

Parameters

RunRef [in, out]

A pointer to an EX_RUNDOWN_REF structure that was initialized by a previous call to the ExInitializeRundownProtection routine. The run-down protection routines use this structure to track the run-down status of the associated shared object. This structure is opaque to drivers.

Remarks

This routine is called by the driver that owns an object that resides in shared memory and that is accessed by other drivers.

ExReInitializeRundownProtection enables a previously used EX_RUNDOWN_REF structure to be associated with a new object, and initializes run-down protection on this object. After the ExReInitializeRundownProtection call, drivers can call ExAcquireRundownProtection to acquire run-down protection on the new object.

An ExReInitializeRundownProtection call must be preceded by a call to the ExWaitForRundownProtectionRelease routine that runs down the old object. Between the ExWaitForRundownProtectionRelease and ExReInitializeRundownProtection calls, the driver might call the ExRundownCompleted routine to indicate that the run down of the old object has completed.

On entry, the status information in the EX_RUNDOWN_REF structure must indicate that the old object was run down.

For more information, see Run-Down Protection.

See also

EX_RUNDOWN_REF

ExAcquireRundownProtection

ExInitializeRundownProtection

ExRundownCompleted

ExWaitForRundownProtectionRelease