EVT_WDF_DEVICE_RESOURCES_QUERY función de devolución de llamada (wdfpdo.h)
[Solo se aplica a KMDF]
La función de devolución de llamada de eventos EvtDeviceResourcesQuery del controlador de bus crea una lista de recursos que representa la configuración de arranque de un dispositivo especificado.
Sintaxis
EVT_WDF_DEVICE_RESOURCES_QUERY EvtWdfDeviceResourcesQuery;
NTSTATUS EvtWdfDeviceResourcesQuery(
[in] WDFDEVICE Device,
[in] WDFCMRESLIST Resources
)
{...}
Parámetros
[in] Device
Identificador de un objeto de dispositivo de marco.
[in] Resources
Identificador de un objeto de lista de recursos de marco que representa una lista de recursos vacía.
Valor devuelto
Si el controlador no encontró ningún error, debe devolver STATUS_SUCCESS (independientemente de si especifica o no los recursos de configuración de arranque). Si el controlador encuentra errores, debe devolver un valor NTSTATUS que NT_SUCCESS se evalúa como FALSE.
Para obtener más información sobre los valores devueltos de esta función de devolución de llamada, consulte Informes de errores de dispositivo.
Comentarios
Los controladores de bus basados en framework pueden proporcionar una función de devolución de llamada EvtDeviceResourcesQuery . Para registrar esta función de devolución de llamada, los controladores de bus llaman a WdfPdoInitSetEventCallbacks.
El marco llama a la función de devolución de llamada EvtDeviceResourcesQuery del controlador de bus para obtener una lista de recursos que especifica la configuración de arranque del dispositivo.
El controlador debe rellenar el objeto de lista de recursos proporcionado con recursos de hardware que representen los requisitos de arranque del dispositivo. Los controladores para dispositivos PnP obtienen esta información de requisitos del BIOS del sistema.
Para crear una lista de recursos, el controlador llama a los métodos de objeto de lista de recursos del marco que agregan recursos al objeto resource-list representado por el parámetro Resources . Para obtener más información sobre los recursos de hardware y la creación de listas de recursos, 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 | wdfpdo.h (incluya Wdf.h) |
| IRQL | PASSIVE_LEVEL |