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