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 de 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, vea errores de creación de objetos de Framework.
Se produce una comprobación de errores del sistema si el controlador proporciona un identificador de objeto no válido.
Observaciones
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 llamador se convierte en el elemento primario del nuevo objeto resource-range-list. El controlador no puede cambiar este elemento primario y el miembro parentObject de o la estructura WDF_OBJECT_ATTRIBUTES debe ser null.
Ejemplos
Para obtener un ejemplo de código que usa WdfIoResourceListCreate, vea WdfIoResourceResourceRequirementsListAppendIoResList.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| encabezado de | wdfresource.h (incluya Wdf.h) |
| biblioteca de | 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) |