функция обратного вызова EVT_WDF_DEVICE_RESOURCES_QUERY (wdfpdo.h)
[Применяется только к 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 |