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

Статья
08/08/2023

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

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

Синтаксис

EVT_WDF_DEVICE_RESOURCES_QUERY EvtWdfDeviceResourcesQuery;

NTSTATUS EvtWdfDeviceResourcesQuery(
  [in] WDFDEVICE Device,
  [in] WDFCMRESLIST Resources
)
{...}

Параметры

[in] Device

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

[in] Resources

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

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

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

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

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

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

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

Чтобы создать список ресурсов, драйвер вызывает методы объекта списка ресурсов платформы , которые добавляют ресурсы в объект resource-list, представленный параметром Resources . Дополнительные сведения об аппаратных ресурсах и создании списков ресурсов см. в разделе Аппаратные ресурсы для драйверов Framework-Based.

Требования

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

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

EvtDeviceResourceRequirementsQuery

Share via