Framework Object Custom Types

Starting in KMDF version 1.11, the framework supports custom type names. A custom type name is a string that driver can associate with a WDFOBJECT instance. Drivers define their own custom type names. The driver specifies a custom type name for an object after the driver has called the object's creation method.

Use these macros to manipulate custom type names:

• To define a custom type name, call WDF_DECLARE_CUSTOM_TYPE from an area of the driver that declares global data, such as a header file.
• Call WdfObjectAddCustomType or WdfObjectAddCustomTypeWithData to associate a custom type with a framework object.
• Call WdfObjectIsCustomType to determine whether a specified object is of a specified custom type.
• After calling WdfObjectAddCustomTypeWithData, the driver can later call WdfObjectGetCustomTypeData to retrieve the data.

A driver can associate multiple custom types with a single framework object. A driver can also associate multiple framework objects with a single custom type.

In output from KMDF debugger extensions, custom type names are displayed along with other WDF object information.

WDF_Object_Name, [custom_Type1_Name, custom_Type2_Name]