WdfCollectionRemoveItem 函式 (wdfcollection.h)
[適用於 KMDF 和 UMDF]
WdfCollectionRemoveItem 方法會根據指定的索引值,從物件集合中移除指定的物件。
語法
void WdfCollectionRemoveItem(
[in] WDFCOLLECTION Collection,
[in] ULONG Index
);
參數
[in] Collection
集合物件的句柄。
[in] Index
以零起始的索引,可識別要移除的物件。
傳回值
沒有
言論
如果驅動程式提供無效的物件句柄,就會發生錯誤檢查。
索引值代表物件加入至集合的順序。 零的索引值代表第一個加入至集合的物件、一個的索引值代表第二個物件等等。
當 WdfCollectionRemoveItem 從集合中移除物件時,它會遞減對象的參考計數。
如需物件集合的詳細資訊,請參閱 Framework 物件集合
例子
如需使用 WdfCollectionRemoveItem的程式代碼範例,請參閱 WdfCollectionGetFirstItem。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
最低 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) |