Funzione WdfCmResourceListGetDescriptor (wdfresource.h)

  • Articolo

[Si applica a KMDF e UMDF]

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

Sintassi

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

Parametri

[in] List

Handle a un oggetto resource-list framework che rappresenta un elenco di risorse hardware per un dispositivo.

[in] Index

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

Valore restituito

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

Un controllo del bug di sistema si verifica se il driver fornisce un handle di oggetti non valido.

Commenti

Il driver non può modificare il descrittore della risorsa recuperato da WdfCmResourceListGetDescriptor .

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

Esempio

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

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Versione UMDF minima 2,0
Intestazione wdfresource.h (includere Wdf.h)
Libreria Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

CM_PARTIAL_RESOURCE_DESCRIPTOR