Funzione WdfCollectionGetLastItem (wdfcollection.h)
[Si applica a KMDF e UMDF]
Il metodo WdfCollectionGetLastItem restituisce un handle all'ultimo oggetto contenuto in un insieme di oggetti.
Sintassi
WDFOBJECT WdfCollectionGetLastItem(
[in] WDFCOLLECTION Collection
);
Parametri
[in] Collection
Handle di un insieme.
Valore restituito
WdfCollectionGetLastItem restituisce un handle all'oggetto attualmente alla fine 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 viene ottenuto un handle per l'ultimo oggetto contenuto in una raccolta di oggetti.
WDFOBJECT lastItem;
lastItem = WdfCollectionGetLastItem(hCollection);
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) |