WDF_EXECUTION_LEVEL enumeration

[Applies to KMDF and UMDF]

The WDF_EXECUTION_LEVEL enumeration type specifies the maximum IRQL at which the framework will call the event callback functions that a driver has supplied for a framework object.

Syntax


typedef enum _WDF_EXECUTION_LEVEL { 
  WdfExecutionLevelInvalid            = 0x00,
  WdfExecutionLevelInheritFromParent  = 0x1,
  WdfExecutionLevelPassive            = 0x2,
  WdfExecutionLevelDispatch           = 0x3
} WDF_EXECUTION_LEVEL;

Constants

WdfExecutionLevelInvalid

Reserved for system use.

WdfExecutionLevelInheritFromParent

The framework uses the maximum IRQL value of the object's parent, unless the object is one that requires IRQL = DISPATCH_LEVEL (such as a DPC object). This value is the default if a driver does not specify a WDF_EXECUTION_LEVEL-typed value.

WdfExecutionLevelPassive

The framework always calls the object's callback functions at IRQL = PASSIVE_LEVEL.

WdfExecutionLevelDispatch

The framework calls the object's callback functions at IRQL <= DISPATCH_LEVEL. Not available in UMDF.

Remarks

Drivers use the WDF_EXECUTION_LEVEL enumeration type to specify the ExecutionLevel member of an object's WDF_OBJECT_ATTRIBUTES structure.

You can specify an ExecutionLevel value for the following objects:

  • Framework driver objects

  • Framework device objects

  • Framework file objects

  • Framework general objects

  • Framework queue objects (Framework versions 1.9 and later)

  • Framework timer objects (Framework versions 1.9 and later)

KMDF By default, the framework sets the ExecutionLevel value of framework driver objects to WdfExecutionLevelDispatch.

UMDF By default, the framework sets the ExecutionLevel value of framework driver objects to WdfExecutionLevelPassive.

The default ExecutionLevel value for all other objects is WdfExecutionLevelInheritFromParent.

For more information about execution levels for event callback functions, see Synchronization Techniques for Framework-Based Drivers.

Requirements

Minimum KMDF version

1.0

Minimum UMDF version

2.0

Header

Wdfobject.h (include Wdf.h)

See also

WDF_OBJECT_ATTRIBUTES

 

 

Send comments about this topic to Microsoft

Anzeigen:
© 2015 Microsoft