WdfCollectionRemoveItem 函数 （wdfcollection.h）

[适用于 KMDF 和 UMDF]

WdfCollectionRemoveItem 方法基于指定的索引值从对象集合中删除指定对象。

语法

VOID WdfCollectionRemoveItem(
  [in] WDFCOLLECTION Collection,
  [in] ULONG         Index
);

参数

[in] Collection

集合对象的句柄。

[in] Index

一个从零开始的索引，用于标识要删除的对象。

返回值

没有

言论

如果驱动程序提供无效的对象句柄，则会发生 bug 检查。

索引值表示对象添加到集合的顺序。 索引值为零表示添加到集合的第一个对象、一个索引值表示第二个对象等。

当 WdfCollectionRemoveItem 从集合中删除对象时，它会递减对象的引用计数。

有关对象集合的详细信息，请参阅 Framework 对象集合

例子

有关使用 WdfCollectionRemoveItem的代码示例，请参阅 WdfCollectionGetFirstItem。

要求

另请参阅

WdfCollectionRemove