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

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

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

Синтаксис

EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY EvtWdfDeviceResourceRequirementsQuery;

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

Параметры

[in] Device

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

[in] IoResourceRequirementsList

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

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

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

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

Замечания

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

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

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

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

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

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

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

Требования

См. также

EvtDeviceResourcesQuery