Función WdfCmResourceListGetDescriptor (wdfresource.h)
[Se aplica a KMDF y UMDF]
El método WdfCmResourceListGetDescriptor devuelve un puntero a un descriptor de recursos contenido en una lista de recursos especificada.
Sintaxis
PCM_PARTIAL_RESOURCE_DESCRIPTOR WdfCmResourceListGetDescriptor(
[in] WDFCMRESLIST List,
[in] ULONG Index
);
Parámetros
[in] List
Identificador de un objeto de lista de recursos de marco que representa una lista 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 especifica List .
Valor devuelto
WdfCmResourceListGetDescriptor devuelve un puntero a la estructura CM_PARTIAL_RESOURCE_DESCRIPTOR que describe el recurso de hardware que identifica el parámetro Index , si el valor del í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.
Comentarios
El controlador no puede modificar el descriptor de recursos que recupera WdfCmResourceListGetDescriptor .
Para obtener más información sobre las listas de recursos, consulte Recursos de hardware para controladores de Framework-Based.
Ejemplos
Para obtener un ejemplo de código que usa WdfCmResourceListGetDescriptor, vea WdfCmResourceListGetCount.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | wdfresource.h (incluya Wdf.h) |
| Library | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |