функция обратного вызова EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES (wdffdo.h)
[Применимо только к KMDF]
Функция обратного вызова событий драйвера EvtDeviceRemoveAddedResources удаляет аппаратные ресурсы, добавленные функцией обратного вызова драйвера EvtDeviceFilterAddRequirements функции обратного вызова.
Синтаксис
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.
Если драйвер предоставляет функцию обратного вызова EvtDeviceFilterAddRequirements обратного вызова, которая добавляет ресурсы в список требований к оборудованию устройства, драйвер также должен предоставить функцию обратного вызова EvtDeviceRemoveAddedResources. Функция обратного вызова EvtDeviceRemoveAddedResources проверяет список ресурсов, назначенный диспетчеру PnP устройства, и удаляет ресурсы из списка, добавленного EvtDeviceFilterAddResourceRequirements функцию обратного вызова. Если драйвер удаляет ресурс, он должен удалить его из необработанных и переведенных списков ресурсов.
Дополнительные сведения о списках ресурсов и порядке отображения ресурсов см. в необработанных и преобразованных аппаратных ресурсов.
Платформа вызывает функцию обратного вызова драйвера EvtDeviceRemoveAddedResources перед тем, как он передает список ресурсов устройства водителю автобуса. Эта функция обратного вызова удаляет добавленные ресурсы, чтобы водитель шины не пытался использовать их.
Дополнительные сведения о функции обратного вызова EvtDeviceRemoveAddedResources см. в изменении списка ресурсов.
Дополнительные сведения об аппаратных ресурсах см. в разделе Аппаратные ресурсы для Framework-Based драйверов.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | универсальный |
| минимальная версия KMDF | 1.0 |
| Заголовок | wdffdo.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL |