Funzione WdfIoResourceListGetDescriptor (wdfresource.h)

[Si applica solo a KMDF]

Il metodo WdfIoResourceListGetDescriptor restituisce un puntatore a un descrittore di risorsa contenuto nell'elenco dei requisiti delle risorse configurazione logica.

Sintassi

PIO_RESOURCE_DESCRIPTOR WdfIoResourceListGetDescriptor(
  [in] WDFIORESLIST ResourceList,
  [in] ULONG        Index
);

Parametri

[in] ResourceList

Handle per 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 ResourceList.

Valore restituito

WdfIoResourceListGetDescriptor restituisce un puntatore alla struttura IO_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 contenuto della struttura IO_RESOURCE_DESCRIPTOR recuperata 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 Framework-Based.

Esempi

Per un esempio di codice che usa WdfIoResourceListGetDescriptor, vedere WdfIoResourceRequirementsListGetIoResList.

Fabbisogno

Vedere anche

IO_RESOURCE_DESCRIPTOR

WdfIoResourceListUpdateDescriptor