функция обратного вызова 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.

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

Требования

См. также

EvtDeviceResourceRequirementsQuery