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 evento EvtDeviceRemoveAddedResources de un controlador quita los recursos de hardware agregados por la función de devolución de llamada EvtDeviceFilterAddResourceRequirements del controlador.
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.
Comentarios
Los controladores de función basados en framework pueden proporcionar una función de devolución de llamada EvtDeviceRemoveAddedResources . Para registrar esta función de devolución de llamada, los controladores llaman a WdfFdoInitSetEventCallbacks.
Si un controlador proporciona una función de devolución de llamada EvtDeviceFilterAddResourceRequirements que agrega recursos a la lista de requisitos de hardware de un dispositivo, el controlador también debe proporcionar una función de devolución de llamada EvtDeviceRemoveAddedResources . 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 agregó la función de devolución de llamada EvtDeviceFilterAddResourceRequirements . 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 función de devolución de llamada EvtDeviceRemoveAddedResources del controlador 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 Modificación de 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 | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Encabezado | wdffdo.h (incluir Wdf.h) |
| IRQL | PASSIVE_LEVEL |