WdfCollectionGetCount 函数 (wdfcollection.h)
[适用于 KMDF 和 UMDF]
WdfCollectionGetCount 方法返回当前在对象集合中的对象数。
语法
ULONG WdfCollectionGetCount(
[in] WDFCOLLECTION Collection
);
参数
[in] Collection
集合对象的句柄。
返回值
WdfCollectionGetCount 返回集合中的对象数。
如果驱动程序提供无效的对象句柄,则会发生系统 bug 检查。
言论
有关对象集合的详细信息,请参阅 Framework 对象集合。
例子
下面的代码示例获取指定集合中的对象数,并使用数字检查集合中的所有对象。
ULONG count;
count = WdfCollectionGetCount(CollectionHandle);
for (i = 0; i < count; i++) {
ObjectHandle = WdfCollectionGetItem(
CollectionHandle,
i
);
//
// Perform object-specific operations.
//
}
要求
要求 | 价值 |
---|---|
目标平台 | 普遍 |
最低 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) |