Funzione WdfCmResourceListGetDescriptor (wdfresource.h)
[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) |