EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS función de devolución de llamada (wdffdo.h)

[Solo se aplica a KMDF]

La función de devolución de llamada de eventos EvtDeviceFilterAddResourceRequirements de un controlador puede agregar recursos a un conjunto de requisitos de recursos de hardware antes de que el sistema asigne recursos a un dispositivo.

La función de devolución de llamada de eventos EvtDeviceFilterRemoveResourceRequirements de un controlador puede quitar recursos de un conjunto de requisitos de recursos de hardware antes de que el sistema asigne recursos a un dispositivo.

Sintaxis

EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS EvtWdfDeviceFilterResourceRequirements;

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

Parámetros

[in] Device

Identificador del objeto de dispositivo de marco al que se asignarán los recursos.

[in] IoResourceRequirementsList

Identificador de un objeto resource-requirements-list, que representa la lista de requisitos de recursos del 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 EvtDeviceFilterAddResourceRequirements y EvtDeviceFilterRemoveResourceRequirements. Para registrar estas funciones de devolución de llamada, los controladores llaman a WdfFdoInitSetEventCallbacks.

Cuando el marco llama a la función de devolución de llamada EvtDeviceFilterAddResourceRequirements de un controlador, el controlador puede agregar descriptores de recursos a una configuración lógica y puede proporcionar configuraciones lógicas adicionales. Estos elementos agregados representan recursos que el controlador de función requiere para que el dispositivo esté operativo.

Si la función de devolución de llamada EvtDeviceFilterAddResourceRequirements de un controlador agrega elementos a la lista de requisitos de recursos de un dispositivo y, si el administrador de PnP asigna los recursos a la lista de requisitos del dispositivo, la función de devolución de llamada EvtDeviceRemoveAddedResources del controlador debe quitar los recursos agregados de la lista de recursos del dispositivo.

Para agregar o quitar elementos de una lista de requisitos de recursos, el controlador llama a los métodos de objeto resource-requirements-list del marco y a los métodos de objeto resource-range-list del marco, que manipula el objeto resource-requirements-list representado por el parámetro IoResourceRequirementsList .

Para obtener más información sobre estas funciones de devolución de llamada, consulte Modificación de una lista de requisitos de recursos.

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

Para obtener información sobre cómo modificar los recursos de interrupción (por ejemplo, afinidad de procesador), vea la sección Comentarios de WdfInterruptSetPolicy.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Encabezado	wdffdo.h (incluir Wdf.h)
IRQL	PASSIVE_LEVEL

Consulte también

EvtDeviceRemoveAddedResources