ExInitializeRundownProtection function

The ExInitializeRundownProtection routine initializes run-down protection on a shared object.

Syntax

void ExInitializeRundownProtection(
  PEX_RUNDOWN_REF RunRef
);

Parameters

RunRef

A pointer to a caller-allocated EX_RUNDOWN_REF structure that is to be initialized. The allocation must be 4-byte aligned on 32-bit platforms, and 8-byte aligned on 64-bit platforms. For more information, see Remarks.

Return Value

None.

Remarks

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

ExInitializeRundownProtection must be called to initialize an EX_RUNDOWN_REF structure before it is passed as a parameter to any other run-down protection routine.

The run-down protection routines use the EX_RUNDOWN_REF structure to track the run-down status of a shared object that is associated with the structure. This status information includes a count of instances of run-down protection that are currently in effect on the object. ExInitializeRundownProtection initializes this count to zero.

After an EX_RUNDOWN_REF structure is initialized, other drivers that access the associated object can call the ExAcquireRundownProtection and ExReleaseRundownProtection routines to acquire and release run-down protection on the object.

For more information, see Run-Down Protection.

Requirements

   
Minimum supported client Available starting with Windows XP.
Target Platform Universal
Header wdm.h (include Wdm.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL "<= APC_LEVEL"

See Also

EX_RUNDOWN_REF

ExAcquireRundownProtection

ExReleaseRundownProtection