Пользовательские типы объектов Фреймворк

Начиная с KMDF версии 1.11 платформа поддерживает пользовательские имена типов. Имя пользовательского типа — это строка, которую драйвер может связать с экземпляром объекта типа WDFOBJECT. Драйверы определяют собственные настраиваемые имена типов. Драйвер задает наименование пользовательского типа для объекта после вызова метода создания объекта.

Используйте эти макросы для манипуляции именами пользовательских типов.

• Чтобы определить имя пользовательского типа, вызовите WDF_DECLARE_CUSTOM_TYPE из области драйвера, которая объявляет глобальные данные, например файл заголовка.
• Вызовите WdfObjectAddCustomType или WdfObjectAddCustomTypeWithData, чтобы связать настраиваемый тип с объектом платформы.
• Вызовите WdfObjectIsCustomType, чтобы определить, является ли указанный объект указанным пользовательским типом.
• После вызова WdfObjectAddCustomTypeWithDataдрайвер может позже вызвать WdfObjectGetCustomTypeData для получения данных.

Драйвер может связать несколько пользовательских типов с одним объектом платформы. Драйвер также может связать несколько объектов платформы с одним пользовательским типом.

В выходных данных из расширений отладчика KMDF имена настраиваемых типов отображаются вместе с другими сведениями об объекте WDF.

WDF_Object_Name, [custom_Type1_Name, custom_Type2_Name]