Edit

WDF_DPC_CONFIG structure (wdfdpc.h)

  • Article

[Applies to KMDF only]

The WDF_DPC_CONFIG structure contains configuration information for a DPC object.

Syntax

typedef struct _WDF_DPC_CONFIG {
  ULONG       Size;
  PFN_WDF_DPC EvtDpcFunc;
  BOOLEAN     AutomaticSerialization;
} WDF_DPC_CONFIG, *PWDF_DPC_CONFIG;

Members

Size

The size, in bytes, of this structure.

EvtDpcFunc

A pointer to the driver's EvtDpcFunc callback function.

AutomaticSerialization

A Boolean value that, if TRUE, indicates that the framework will synchronize execution of the DPC object's EvtDpcFunc callback function with callback functions from other objects that are underneath the DPC object's parent. For more information, see the following Remarks section.

Remarks

The WDF_DPC_CONFIG structure is used as input to WdfDpcCreate.

To initialize a WDF_DPC_CONFIG structure, your driver should first call WDF_DPC_CONFIG_INIT and then fill in structure members that WDF_DPC_CONFIG_INIT does not initialize.

Setting AutomaticSerialization to TRUE has no effect if the parent device object's synchronization scope is set to WdfSynchronizationScopeNone.

Setting AutomaticSerialization to TRUE causes WdfDpcCreate to fail if the parent device object's execution level is set to WdfExecutionLevelPassive.

For more information about AutomaticSerialization and synchronizing driver callback functions, see Synchronization Techniques for Framework-Based Drivers.

For more information about handling interrupts in framework-based drivers, see Handling Hardware Interrupts.

Requirements

Requirement Value
Minimum KMDF version 1.0
Header wdfdpc.h (include Wdf.h)

See also

EvtDpcFunc

KDPC

WDF_DPC_CONFIG_INIT

WdfDpcCreate