共用方式為


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)

另請參閱

WdfCollectionRemove