Función WdfIoResourceListCreate (wdfresource.h)

[Solo se aplica a KMDF]

El método WdfIoResourceListCreate crea una configuración lógica vacía, que se puede rellenar y agregar a una lista de requisitos de recursos.

Sintaxis

NTSTATUS WdfIoResourceListCreate(
  [in]           WDFIORESREQLIST        RequirementsList,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          WDFIORESLIST           *ResourceList
);

Parámetros

[in] RequirementsList

Identificador de un objeto resource-requirements-list del marco que representa la lista de requisitos de recursos de un dispositivo.

[in, optional] Attributes

Puntero a una estructura de WDF_OBJECT_ATTRIBUTES asignada por el autor de la llamada que contiene atributos para el nuevo objeto. (El miembro ParentObject de la estructura debe ser NULL). Este parámetro es opcional y se puede WDF_NO_OBJECT_ATTRIBUTES.

[out] ResourceList

Identificador de un objeto de lista de intervalos de recursos de marco que representa la nueva configuración lógica.

Valor devuelto

WdfIoResourceListCreate devuelve STATUS_SUCCESS si la operación se realiza correctamente.

Para obtener valores devueltos adicionales, consulte Errores de creación de objetos de marco.

Se produce una comprobación de errores del sistema si el controlador proporciona un identificador de objeto no válido.

Comentarios

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

El objeto resource-requirements-list especificado por el autor de la llamada se convierte en el elemento primario del nuevo objeto resource-range-list. El controlador no puede cambiar este elemento primario y el miembro ParentObject o la estructura WDF_OBJECT_ATTRIBUTES debe ser NULL.

Ejemplos

Para obtener un ejemplo de código que usa WdfIoResourceListCreate, vea WdfIoResourceResourceRequirementsListAppendIoResList.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Encabezado	wdfresource.h (incluya Wdf.h)
Library	Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL	<=DISPATCH_LEVEL
Reglas de cumplimiento de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WDF_OBJECT_ATTRIBUTES