Condividi tramite


Funzione WdfCollectionGetFirstItem (wdfcollection.h)

[Si applica a KMDF e UMDF]

Il metodo WdfCollectionGetFirstItem restituisce un handle al primo oggetto contenuto in un insieme di oggetti.

Sintassi

WDFOBJECT WdfCollectionGetFirstItem(
  [in] WDFCOLLECTION Collection
);

Parametri

[in] Collection

Handle per un oggetto raccolta.

Valore restituito

WdfCollectionGetFirstItem restituisce un handle all'oggetto che si trova attualmente all'inizio dell'elenco di oggetti dell'insieme specificato oppure NULL se l'elenco è vuoto.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Commenti

Per altre informazioni sulle raccolte di oggetti, vedere Framework Object Collections.

Esempio

Nell'esempio di codice seguente ogni elemento viene rimosso da una raccolta ed eliminato l'oggetto di ogni elemento.

while ((subRequest = WdfCollectionGetFirstItem(hCollection)) != NULL) {
    WdfCollectionRemoveItem(
                            hCollection,
                            0
                            );
    WdfObjectDelete(subRequest);
}

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Versione UMDF minima 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)

Vedi anche

WdfCollectionGetItem

WdfCollectionGetLastItem