WdfCollectionGetLastItem function (wdfcollection.h)
[Applies to KMDF and UMDF]
The WdfCollectionGetLastItem method returns a handle to the last object that is in an object collection.
Syntax
WDFOBJECT WdfCollectionGetLastItem(
[in] WDFCOLLECTION Collection
);
Parameters
[in] Collection
A handle to a collection object.
Return value
WdfCollectionGetLastItem returns a handle to the object that is currently at the end of the specified collection's list of objects, or NULL if the list is empty.
A bug check occurs if the driver supplies an invalid object handle.
Remarks
For more information about object collections, see Framework Object Collections.
Examples
The following code example obtains a handle to the last object that is in an object collection.
WDFOBJECT lastItem;
lastItem = WdfCollectionGetLastItem(hCollection);
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Universal |
| Minimum KMDF version | 1.0 |
| Minimum UMDF version | 2.0 |
| Header | wdfcollection.h (include Wdf.h) |
| Library | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <= DISPATCH_LEVEL |
| DDI compliance rules | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |