Función WdfCmResourceListGetDescriptor (wdfresource.h)

  • Artículo

[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)

Consulte también

CM_PARTIAL_RESOURCE_DESCRIPTOR