WdfCollectionCreate function (wdfcollection.h)

[Applies to KMDF and UMDF]

The WdfCollectionCreate method creates a framework collection object.

Syntax

NTSTATUS WdfCollectionCreate(
  [in, optional] PWDF_OBJECT_ATTRIBUTES CollectionAttributes,
  [out]          WDFCOLLECTION          *Collection
);

Parameters

[in, optional] CollectionAttributes

A pointer to a caller-allocated WDF_OBJECT_ATTRIBUTES structure that contains attributes for the new collection object. This parameter is optional and can be WDF_NO_OBJECT_ATTRIBUTES.

[out] Collection

A pointer to a location that receives a handle to the new collection object.

Return value

WdfCollectionCreate returns STATUS_SUCCESS if the operation succeeds. Otherwise, this method might return one of the following values:

This method might also return other NTSTATUS values.

Remarks

After calling WdfCollectionCreate to create a framework collection object, a driver can call WdfCollectionAdd to add objects to the collection.

By default, the new collection object's parent is the framework driver object that the WdfDriverCreate method created. You can use the ParentObject member of the WDF_OBJECT_ATTRIBUTES structure to specify a different parent. The framework deletes the collection object when it deletes the parent object. If your driver does not change the default parent, the driver should delete the collection object when it has finished using the object; otherwise, the object will remain until the I/O manager unloads your driver.

For more information about object collections, see Framework Object Collections.

Examples

For a code example that uses WdfCollectionCreate, see WdfCollectionAdd.

Requirements

See also

WDF_OBJECT_ATTRIBUTES

WdfCollectionAdd

WdfCollectionRemove

WdfDriverCreate