Funzione WdfCmResourceListGetDescriptor (wdfresource.h)

Articolo
02/07/2025

[Si applica a KMDF e UMDF]

Il metodo WdfCmResourceListGetDescriptor restituisce un puntatore a un descrittore di risorsa contenuto in un elenco di risorse specificato.

Sintassi

PCM_PARTIAL_RESOURCE_DESCRIPTOR WdfCmResourceListGetDescriptor(
  [in] WDFCMRESLIST List,
  [in] ULONG        Index
);

Parametri

[in] List

Handle per un oggetto elenco di risorse framework che rappresenta un elenco di risorse hardware per un dispositivo.

[in] Index

Valore in base zero utilizzato come indice nella configurazione logica specificata List.

Valore restituito

WdfCmResourceListGetDescriptor restituisce un puntatore alla struttura CM_PARTIAL_RESOURCE_DESCRIPTOR che descrive la risorsa hardware identificata dal parametro Index Index, se il valore di indice è valido. In caso contrario, il metodo restituisce NULL.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo dei bug di sistema.

Osservazioni

Il driver non può modificare il descrittore di risorse che WdfCmResourceListGetDescriptor recupera.

Per altre informazioni sugli elenchi di risorse, vedere Risorse hardware per driver Framework-Based.

Esempi

Per un esempio di codice che usa WdfCmResourceListGetDescriptor, vedere WdfCmResourceListGetCount.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfresource.h (include Wdf.h)
libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedere anche

CM_PARTIAL_RESOURCE_DESCRIPTOR

Condividi tramite