WdfCollectionRemove 関数 (wdfcollection.h)

[KMDF と UMDF に適用]

WdfCollectionRemove メソッドは、指定したオブジェクト コレクションからオブジェクトを削除します。

構文

void WdfCollectionRemove(
  [in] WDFCOLLECTION Collection,
  [in] WDFOBJECT     Item
);

パラメーター

[in] Collection

コレクション オブジェクトへのハンドル。

[in] Item

コレクションから削除されるフレームワーク オブジェクトへのハンドル。

戻り値

なし

解説

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

WdfCollectionRemove がコレクションからオブジェクトを削除すると、オブジェクトの参照カウントがデクリメントされます。

オブジェクト コレクションの詳細については、「 Framework オブジェクト コレクション」を参照してください。

例

次のコード例では、指定したオブジェクト コレクションから指定したオブジェクトを削除します。

WdfCollectionRemove(
                    hCollection,
                    hObject
                    );

要件

こちらもご覧ください

WdfCollectionRemoveItem