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

Статья
08/08/2023

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

Функция обратного вызова события EvtDeviceResourceRequirementsQuery водителя шины создает список требований к ресурсам, который представляет необходимые аппаратные ресурсы устройства.

Синтаксис

EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY EvtWdfDeviceResourceRequirementsQuery;

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

Параметры

[in] Device

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

[in] IoResourceRequirementsList

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

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

Если драйвер не обнаружил ошибок, он должен вернуть STATUS_SUCCESS (независимо от того, указывает ли он какой-либо необходимый аппаратный ресурс). Если драйвер сталкивается с ошибками, он должен вернуть значение NTSTATUS, которое NT_SUCCESS принимает значение FALSE.

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

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

Платформа вызывает функцию обратного вызова EvtDeviceResourceRequirementsQuery водителя шины, чтобы получить список требований к ресурсам для устройства.

Драйвер должен заполнить предоставленный объект resource-requirements-list логическими конфигурациями аппаратных ресурсов, которые позволят устройству работать правильно.

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

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

Если драйвер работает в версии операционной системы, более ранней, чем Windows 7, драйвер автобуса может использовать EvtDeviceResourceRequirementsQuery , чтобы задать свойство устройства на дочернем устройстве перед перечислением дочернего устройства.

Чтобы задать свойство устройства в Windows 7 или более поздней версии, водитель автобуса может предоставить подпрограмму предварительной обработки для IRP_MN_DEVICE_ENUMERATED.

Требования

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

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

EvtDeviceResourcesQuery