EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES función de devolución de llamada (wdffdo.h)
[Solo se aplica a KMDF]
La función de devolución de llamada de eventos EvtDeviceRemoveAddedResource s de un controlador quita los recursos de hardware que agrega la función de devolución de llamada de del controlador EvtDeviceFilterAddResourceRequirements función de devolución de llamada.
Sintaxis
EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES EvtWdfDeviceRemoveAddedResources;
NTSTATUS EvtWdfDeviceRemoveAddedResources(
[in] WDFDEVICE Device,
[in] WDFCMRESLIST ResourcesRaw,
[in] WDFCMRESLIST ResourcesTranslated
)
{...}
Parámetros
[in] Device
Identificador del objeto de dispositivo de marco al que se asignarán los recursos.
[in] ResourcesRaw
Identificador de un objeto de lista de recursos que identifica los recursos de hardware sin procesar que el administrador de PnP ha asignado al dispositivo.
[in] ResourcesTranslated
Identificador de un objeto de lista de recursos que identifica los recursos de hardware traducidos que el administrador de PnP ha asignado al dispositivo.
Valor devuelto
Si el controlador no encontró ningún error, debe devolver STATUS_SUCCESS. De lo contrario, debe devolver un valor NTSTATUS que NT_SUCCESS se evalúa como FALSE.
Para obtener más información sobre los valores devueltos, consulte Informes de errores de dispositivo.
Observaciones
Los controladores de función basados en marcos pueden proporcionar una función de devolución de llamada EvtDeviceRemoveAddedResource s. Para registrar esta función de devolución de llamada, los controladores llaman a WdfFdoInitSetEventCallbacks.
Si un controlador proporciona un EvtDeviceFilterAddResourceRequirements función de devolución de llamada que agrega recursos a la lista de requisitos de hardware de un dispositivo, el controlador también debe proporcionar un EvtDeviceRemoveAddedResources función de devolución de llamada. La función de devolución de llamada EvtDeviceRemoveAddedResources examina la lista de recursos que el administrador de PnP ha asignado al dispositivo y quita los recursos de la lista que el EvtDeviceFilterAddResourceRequirements función de devolución de llamada agregada. Si el controlador quita un recurso, debe quitarlo de las listas de recursos sin procesar y traducidas.
Para obtener más información sobre las listas de recursos y el orden en que aparecen los recursos, consulte recursos de hardware sin procesar y traducidos.
El marco llama a la del controlador EvtDeviceRemoveAddedResources función de devolución de llamada inmediatamente antes de pasar la lista de recursos del dispositivo al controlador de bus. Esta función de devolución de llamada quita los recursos agregados para que el controlador de bus no intente usarlos.
Para obtener más información sobre la función de devolución de llamada EvtDeviceRemoveAddedResources, consulte Modificar una lista de recursos.
Para obtener más información sobre los recursos de hardware, consulte Recursos de hardware para controladores de Framework-Based.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| encabezado | wdffdo.h (incluya Wdf.h) |
| irQL | PASSIVE_LEVEL |