WdfCollectionGetItem 函数 （wdfcollection.h）
[适用于 KMDF 和 UMDF]
WdfCollectionGetItem 方法返回指定对象集合中包含的对象的句柄，并与指定的索引值相关联。
语法
WDFOBJECT WdfCollectionGetItem(
[in] WDFCOLLECTION Collection,
[in] ULONG Index
);
参数
[in] Collection
集合对象的句柄。
[in] Index
一个从零开始的索引值，用于标识集合中的对象。
返回值
WdfCollectionGetItem 返回框架对象句柄;如果 索引 值无效，NULL。
如果驱动程序提供无效的对象句柄，则会发生系统 bug 检查。
言论
索引值表示对象添加到集合的顺序。 索引值为零表示集合中的第一个对象，一个索引值表示第二个对象，依此类此类地表示链接列表。 当驱动程序从集合中删除项 i 时，项 i+1 变为项 i。
有关对象集合的详细信息，请参阅 Framework 对象集合。
例子
有关使用 WdfCollectionGetItem的代码示例，请参阅 WdfCollectionGetCount。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 最低 UMDF 版本 | 2.0 |
| 标头 | wdfcollection.h （包括 Wdf.h） |
| 库 | Wdf01000.sys（KMDF）：WUDFx02000.dll （UMDF） |
| IRQL | <= DISPATCH_LEVEL |
| DDI 符合性规则 | DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf） |