Funzione WdfCollectionGetItem (wdfcollection.h)
[Si applica a KMDF e UMDF]
Il metodo WdfCollectionGetItem restituisce un handle all'oggetto contenuto in un insieme di oggetti specificato e associato a un valore di indice specificato.
Sintassi
WDFOBJECT WdfCollectionGetItem(
[in] WDFCOLLECTION Collection,
[in] ULONG Index
);
Parametri
[in] Collection
Handle di un insieme.
[in] Index
Valore di indice in base zero che identifica un oggetto nell'insieme.
Valore restituito
WdfCollectionGetItem restituisce un handle di oggetto framework oppure NULL se il valore index non è valido.
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo dei bug di sistema.
Osservazioni
I valori di indice rappresentano l'ordine in cui gli oggetti vengono aggiunti a una raccolta. Un valore di indice pari a zero rappresenta il primo oggetto dell'insieme, un valore di indice di uno rappresenta il secondo oggetto e così via, come un elenco collegato. Quando il driver rimuove l'elemento i da una raccolta, l'elemento i+1 diventa elemento i.
Per altre informazioni sugli insiemi di oggetti, vedere Framework Object Collections.
Esempi
Per un esempio di codice che usa WdfCollectionGetItem, vedere WdfCollectionGetCount.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| versione minima di UMDF | 2.0 |
| intestazione | wdfcollection.h (include Wdf.h) |
| libreria | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <= DISPATCH_LEVEL |
| regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |