Expand Minimize

ExInitializeRundownProtection routine

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

Syntax


VOID ExInitializeRundownProtection(
  _Out_  PEX_RUNDOWN_REF RunRef
);

Parameters

RunRef [out]

A pointer to a caller-allocated EX_RUNDOWN_REF structure that is to be initialized. 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

Version

Available starting with Windows XP.

Header

Wdm.h (include Wdm.h)

Library

Ntoskrnl.lib

IRQL

<= APC_LEVEL

See also

ExReleaseRundownProtection
ExAcquireRundownProtection
EX_RUNDOWN_REF

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft