Funzione WdfIoResourceListGetDescriptor (wdfresource.h)

  • Articolo

[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)

Vedi anche

IO_RESOURCE_DESCRIPTOR

WdfIoResourceListUpdateDescriptor