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

  • Статья

[Относится только к KMDF]

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

Синтаксис

EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES EvtWdfDeviceRemoveAddedResources;

NTSTATUS EvtWdfDeviceRemoveAddedResources(
  [in] WDFDEVICE Device,
  [in] WDFCMRESLIST ResourcesRaw,
  [in] WDFCMRESLIST ResourcesTranslated
)
{...}

Параметры

[in] Device

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

[in] ResourcesRaw

Дескриптор объекта списка ресурсов, который идентифицирует необработанные аппаратные ресурсы, назначенные диспетчером PnP устройству.

[in] ResourcesTranslated

Дескриптор объекта списка ресурсов, который идентифицирует преобразованные аппаратные ресурсы, назначенные диспетчером PnP устройству.

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

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

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

Комментарии

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

Если драйвер предоставляет функцию обратного вызова EvtDeviceFilterAddResourceRequirements , которая добавляет ресурсы в список требований к оборудованию устройства, драйвер также должен предоставить функцию обратного вызова EvtDeviceRemoveAddedResources . Функция обратного вызова EvtDeviceRemoveAddedResources проверяет список ресурсов, назначенный диспетчером PnP устройству, и удаляет ресурсы из списка, добавленного функцией обратного вызова EvtDeviceFilterAddResourceRequirements . Если драйвер удаляет ресурс, он должен удалить его из необработанных и переведенных списков ресурсов.

Дополнительные сведения о списках ресурсов и порядке их отображения см. в разделе Необработанные и переведенные аппаратные ресурсы.

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

Дополнительные сведения о функции обратного вызова EvtDeviceRemoveAddedResources см. в разделе Изменение списка ресурсов.

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

Требования

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

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

EvtDeviceFilterAddResourceRequirements

EvtDeviceFilterRemoveResourceRequirements