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

Vedi anche

WdfCollectionGetItem

WdfCollectionGetLastItem