Архитектура WDF

WDF предоставляет интерфейсы на основе объектов для драйверов. Интерфейсы объектов, определяемые платформой, состоят из следующих:

методы объекта
Методы — это функции, которые драйвер может вызывать для выполнения операции с объектом или получения или задания свойства объекта. Методы называются WdfObjectAction, где объекта описывает объект и Action указывает, что выполняет функция. Например, WdfDeviceCreate создает объект устройства.

функции обратного вызова событий объекта
Функции обратного вызова событий — это функции, которые предоставляет драйвер. Каждая функция обратного вызова события связана с определенным событием, которое может произойти в объекте. Платформа вызывает функцию обратного вызова событий при возникновении связанного события. По соглашению, заполнители для функций обратного вызова событий называются EvtObjectEvent, хотя в вашем драйвере вы можете назвать эти обратные вызовы как угодно. Например, драйвер регистрирует вызов события EvtDeviceD0Entry, чтобы получать уведомления, когда устройство переходит в рабочее состояние.

свойства объекта
Свойства — это значения, хранящиеся в объекте, и драйвер может получить (то есть получить) и задать (то есть изменить). Во многих случаях свойства напрямую соответствуют полям в соответствующих объектах WDM. Свойства, которые не могут завершиться ошибкой, называются WdfObjectGetValue и WdfObjectSetValue, и свойства, которые могут завершиться ошибкой, называются WdfObjectRetrieveValue и WdfObjectAssignValue. Объект описывает этот объект, а значение определяет данные, которые функция устанавливает или возвращает. Например, WdfDeviceGetDriver возвращает дескриптор объекта драйвера, который связан с объектом устройства.

объект обрабатывает
Драйвер на основе платформы никогда не обращается непосредственно к объектам платформы. Вместо этого драйвер получает дескрипторы объекта, которые он может передать методам объекта.

Платформа определяет несколько типов объектов, которые используют драйверы на основе платформы:

• Объект драйвера в рамках платформы представляет каждый драйвер.

• Объект устройства платформы представляет каждое устройство, которое поддерживает драйвер.

• Объекты очередей Framework соответствуют очередям ввода-вывода, которые принимают запросы на ввод-вывод от устройства.

• Framework запрашивают объекты представляют запросы ввода-вывода, получаемые каждой очередью ввода-вывода.

Список всех объектов, определяемых платформой, см. в сводке объектов Платформы.