Funzione WdfCollectionGetItem (wdfcollection.h)

[Si applica a KMDF e UMDF]

Il metodo WdfCollectionGetItem restituisce un handle all'oggetto contenuto in una raccolta di oggetti specificata e associato a un valore di indice specificato.

Sintassi

WDFOBJECT WdfCollectionGetItem(
  [in] WDFCOLLECTION Collection,
  [in] ULONG         Index
);

Parametri

[in] Collection

Handle per un oggetto raccolta.

[in] Index

Valore di indice in base zero che identifica un oggetto nell'insieme.

Valore restituito

WdfCollectionGetItem restituisce un handle di oggetti framework o NULL se il valore Index non è valido.

Un controllo del bug di sistema si verifica se il driver fornisce un handle di oggetti non valido.

Commenti

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 sulle raccolte di oggetti, vedere Raccolte oggetti Framework.

Esempio

Per un esempio di codice che usa WdfCollectionGetItem, vedere WdfCollectionGetCount.

Requisiti

Vedi anche

WdfCollectionGetFirstItem

WdfCollectionGetLastItem