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

Vedere anche

WdfCollectionGetFirstItem

WdfCollectionGetLastItem