Función WdfIoResourceListGetDescriptor (wdfresource.h)
[Solo se aplica a KMDF]
El método WdfIoResourceListGetDescriptor devuelve un puntero a un descriptor de recursos contenido en la lista de requisitos de recursos configuración lógica.
Sintaxis
PIO_RESOURCE_DESCRIPTOR WdfIoResourceListGetDescriptor(
[in] WDFIORESLIST ResourceList,
[in] ULONG Index
);
Parámetros
[in] ResourceList
Identificador de un objeto framework resource-range-list que representa una configuración lógica de recursos de hardware para un dispositivo.
[in] Index
Valor de base cero que se usa como índice en la configuración lógica que ResourceList especifica.
Valor devuelto
WdfIoResourceListGetDescriptor devuelve un puntero a la estructura de IO_RESOURCE_DESCRIPTOR que describe el recurso de hardware que identifica el parámetro Index, si el valor de índice es válido. De lo contrario, el método devuelve NULL.
Se produce una comprobación de errores del sistema si el controlador proporciona un identificador de objeto no válido.
Observaciones
El controlador no puede modificar el contenido de la estructura de IO_RESOURCE_DESCRIPTOR que WdfIoResourceListGetDescriptor recupera. Para modificar un descriptor de recursos, el controlador puede llamar a WdfIoResourceListUpdateDescriptor.
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.
Ejemplos
Para obtener un ejemplo de código que usa WdfIoResourceListGetDescriptor, vea WdfIoResourceRequirementsListGetIoResList.
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) |