WDF_DRIVER_CONFIG structure (wdfdriver.h)

[Applies to KMDF and UMDF]

The WDF_DRIVER_CONFIG structure is an input parameter to WdfDriverCreate.

Syntax

typedef struct _WDF_DRIVER_CONFIG {
  ULONG                     Size;
  PFN_WDF_DRIVER_DEVICE_ADD EvtDriverDeviceAdd;
  PFN_WDF_DRIVER_UNLOAD     EvtDriverUnload;
  ULONG                     DriverInitFlags;
  ULONG                     DriverPoolTag;
} WDF_DRIVER_CONFIG, *PWDF_DRIVER_CONFIG;

Members

Size

The size, in bytes, of this structure.

EvtDriverDeviceAdd

A pointer to a driver's EvtDriverDeviceAdd callback function.

EvtDriverUnload

A pointer to a driver's EvtDriverUnload callback function.

DriverInitFlags

A bitwise OR of one or more WDF_DRIVER_INIT_FLAGS-typed values that identify driver initialization flags.

DriverPoolTag

(KMDF versions 1.5 and later.) A driver-defined pool tag that the framework will assign to all of the driver's pool allocations. Debuggers display this tag. For more information about specifying a pool tag, see the following Remarks section.

Remarks

Your driver can optionally specify a pool tag that the framework will assign to all of the driver's pool allocations. Drivers typically specify a character string of up to four characters, delimited by single quotation marks, in reverse order (for example, 'dcba'). The ASCII value of each character in the tag must be between 0 and 127.

If DriverPoolTag is zero, the framework creates a default pool tag by using the first four characters of your driver's kernel-mode service name. If the service name begins with "WDF" (the name is not case sensitive and does not include the quotation marks), the next four characters are used. If fewer than four characters are available, "FxDr" is used.

To initialize a WDF_DRIVER_CONFIG structure, drivers must call WDF_DRIVER_CONFIG_INIT.

Requirements

Requirement Value
Minimum KMDF version 1.0
Minimum UMDF version 2.0
Header wdfdriver.h (include Wdf.h)

See also

EvtDriverDeviceAdd

EvtDriverUnload

WDF_DRIVER_CONFIG_INIT

WDF_DRIVER_INIT_FLAGS

WdfDriverCreate