Funzione WdfCollectionGetFirstItem (wdfcollection.h)

Articolo
02/07/2025

[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 di un insieme.

Valore restituito

WdfCollectionGetFirstItem restituisce un handle all'oggetto 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.

Osservazioni

Per altre informazioni sugli insiemi di oggetti, vedere Framework Object Collections.

Esempi

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);
}

Fabbisogno

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

Vedere anche

WdfCollectionGetItem

WdfCollectionGetLastItem

Condividi tramite