функция обратного вызова EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS (wdffdo.h)

Статья
02/27/2024

[Применяется только к KMDF]

Функция обратного вызова события EvtDeviceFilterAddResourceRequirements может добавлять ресурсы в набор требований к аппаратным ресурсам, прежде чем система назначит ресурсы устройству.

Функция обратного вызова события EvtDeviceFilterRemoveResourceRequirements может удалять ресурсы из набора требований к ресурсам оборудования, прежде чем система назначит ресурсы устройству.

Синтаксис

EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS EvtWdfDeviceFilterResourceRequirements;

NTSTATUS EvtWdfDeviceFilterResourceRequirements(
  [in] WDFDEVICE Device,
  [in] WDFIORESREQLIST IoResourceRequirementsList
)
{...}

Параметры

[in] Device

Дескриптор объекта устройства платформы, которому будут назначены ресурсы.

[in] IoResourceRequirementsList

Дескриптор объекта resource-requirements-list, который представляет список требований к ресурсам устройства.

Возвращаемое значение

Если драйвер не обнаружил ошибок, он должен вернуть STATUS_SUCCESS. В противном случае он должен вернуть значение NTSTATUS, которое NT_SUCCESS принимает значение FALSE.

Дополнительные сведения о возвращаемых значениях см. в разделе Отчеты о сбоях устройств.

Драйверы функций на основе платформы могут предоставлять функцию обратного вызова EvtDeviceFilterAddResourceRequirements и функцию обратного вызова EvtDeviceFilterRemoveResourceRequirements. Чтобы зарегистрировать эти функции обратного вызова, драйверы вызывают WdfFdoInitSetEventCallbacks.

Когда платформа вызывает функцию обратного вызова EvtDeviceFilterAddResourceRequirements драйвера, драйвер может добавлять дескрипторы ресурсов в логическую конфигурацию и предоставлять дополнительные логические конфигурации. Эти добавленные элементы представляют ресурсы, необходимые драйверу функции для обеспечения работоспособности устройства.

Если функция обратного вызова EvtDeviceFilterAddRequirements драйвера добавляет элементы в список требований к ресурсам устройства и если диспетчер PnP назначает ресурсы списку требований устройства, функция обратного вызова EvtDeviceRemoveAddedResources драйвера должна удалить добавленные ресурсы из списка ресурсов устройства.

Чтобы добавить элементы в список требований к ресурсам или удалить их из него, драйвер вызывает методы объекта framework resource-requirements-list и методы объектов framework resource-range-list, которые управляют объектом resource-requirements-list, представленным параметром IoResourceRequirementsList .

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

Дополнительные сведения о аппаратных ресурсах и списках требований к ресурсам см. в статье Аппаратные ресурсы для Framework-Based Drivers.

Сведения об изменении ресурсов прерываний (например, сходства процессоров) см. в разделе Примечания статьи WdfInterruptSetPolicy.

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1,0
Верхняя часть	wdffdo.h (включая Wdf.h)
IRQL	PASSIVE_LEVEL

См. также раздел

EvtDeviceRemoveAddedResources

Поделиться через