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

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Versione UMDF minima 2,0
Intestazione wdfcollection.h (includere Wdf.h)
Libreria Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WdfCollectionGetFirstItem

WdfCollectionGetLastItem