Hardware Dev Center

WdfCollectionGetLastItem method

[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

Collection [in]

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

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, KmdfIrql, KmdfIrql2

See also

WdfCollectionGetFirstItem
WdfCollectionGetItem

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft