EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY función de devolución de llamada (wdfpdo.h)

[Solo se aplica a KMDF]

Una función de devolución de llamada de eventos EvtDeviceResourceResourceRequirementsQuery del controlador de bus crea una lista de requisitos de recursos que representa los recursos de hardware necesarios del dispositivo.

Sintaxis

EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY EvtWdfDeviceResourceRequirementsQuery;

NTSTATUS EvtWdfDeviceResourceRequirementsQuery(
  [in] WDFDEVICE Device,
  [in] WDFIORESREQLIST IoResourceRequirementsList
)
{...}

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

[in] IoResourceRequirementsList

Identificador de un objeto resource-requirements-list de marco que representa una lista de requisitos de recursos vacíos.

Valor devuelto

Si el controlador no encontró ningún error, debe devolver STATUS_SUCCESS (independientemente de si especifica o no ningún recurso de hardware necesario). 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 marco pueden proporcionar una función de devolución de llamada EvtDeviceResourceRequirementsQuery . 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 EvtDeviceResourceRequirementsQuery del controlador de bus para obtener una lista de requisitos de recursos para el dispositivo.

El controlador debe rellenar el objeto resource-requirements-list proporcionado con configuraciones lógicas de recursos de hardware que permitirán que el dispositivo funcione correctamente.

Para crear una lista de requisitos de recursos, el controlador llama a métodos de objeto framework resource-range-list, que agregan descriptores de recursos a configuraciones lógicas y métodos de objeto resource-requirements-list del marco, que agregan configuraciones lógicas a la lista de requisitos de recursos.

Para obtener más información sobre los recursos de hardware y la creación de listas de requisitos de recursos, consulte Recursos de hardware para controladores de Framework-Based.

Si un controlador se ejecuta en una versión del sistema operativo anterior a Windows 7, un controlador de bus puede usar EvtDeviceResourceResourceRequirementsQuery para establecer una propiedad de dispositivo en un dispositivo secundario antes de enumerar el elemento secundario.

Para establecer una propiedad de dispositivo en Windows 7 o posterior, un controlador de bus puede proporcionar una rutina de preprocesamiento para IRP_MN_DEVICE_ENUMERATED.

Requisitos

Consulte también

EvtDeviceResourcesQuery