Función WdfIoResourceListGetDescriptor (wdfresource.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfIoResourceListGetDescriptor devuelve un puntero a un descriptor de recursos contenido en la configuración lógica de una lista de requisitos de recursos.

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 IO_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 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 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

IO_RESOURCE_DESCRIPTOR

WdfIoResourceListUpdateDescriptor