WUDF_WORKITEM_CONFIG structure (wudfworkitem.h)

[Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.]

The

WUDF_WORKITEM_CONFIG structure contains information that is associated with a work item.

Syntax

typedef struct _WUDF_WORKITEM_CONFIG {
  ULONG             Size;
  PFN_WUDF_WORKITEM OnWorkItemFunc;
  BOOLEAN           AutomaticSerialization;
} WUDF_WORKITEM_CONFIG, *PWUDF_WORKITEM_CONFIG;

Members

Size

The size, in bytes, of this structure.

OnWorkItemFunc

The address of an OnWorkItem callback function.

AutomaticSerialization

A Boolean value that, if TRUE, indicates that the framework will synchronize execution of the OnWorkItem callback function with callback functions from other objects that are underneath the work-item object's parent object. If FALSE, the framework does not synchronize execution of the OnWorkItem callback function.

Remarks

Your driver must initialize the WUDF_WORKITEM_CONFIG structure by calling WUDF_WORKITEM_CONFIG_INIT. Your driver can then pass the structure to the IWDFDevice3::CreateWorkItem method as an input parameter.

Setting the AutomaticSerialization member of WUDF_WORKITEM_CONFIG to TRUE has no effect if the driver did not enable automatic callback synchronization by calling IWDFDeviceInitialize::SetLockingConstraint.

Requirements

Requirement	Value
Minimum UMDF version	1.11
Header	wudfworkitem.h

See also

IWDFDevice3::CreateWorkItem

OnWorkItem

WUDF_WORKITEM_CONFIG_INIT