Funzione WdfIoResourceListGetDescriptor (wdfresource.h)
[Si applica solo a KMDF]
Il metodo WdfIoResourceListGetDescriptor restituisce un puntatore a un descrittore di risorse contenuto nella configurazione logica di un elenco dei requisiti delle risorse.
Sintassi
PIO_RESOURCE_DESCRIPTOR WdfIoResourceListGetDescriptor(
[in] WDFIORESLIST ResourceList,
[in] ULONG Index
);
Parametri
[in] ResourceList
Handle a un oggetto framework resource-range-list che rappresenta una configurazione logica delle risorse hardware per un dispositivo.
[in] Index
Valore in base zero utilizzato come indice nella configurazione logica specificata da ResourceList .
Valore restituito
WdfIoResourceListGetDescriptor restituisce un puntatore alla struttura IO_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 contenuto della struttura IO_RESOURCE_DESCRIPTOR recuperata da WdfIoResourceListGetDescriptor . Per modificare un descrittore di risorse, il driver può chiamare WdfIoResourceListUpdateDescriptor.
Per altre informazioni sugli elenchi di requisiti delle risorse e sulle configurazioni logiche, vedere Risorse hardware per i driver di Framework-Based.
Esempio
Per un esempio di codice che usa WdfIoResourceListGetDescriptor, vedere WdfIoResourceRequirementsListGetIoResList.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Intestazione | wdfresource.h (includere Wdf.h) |
| Libreria | Wdf01000.sys (vedere Framework Library Versioning). |
| IRQL | <=DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |