Fungsi WdfCollectionRemove (wdfcollection.h)

[Berlaku untuk KMDF dan UMDF]

Metode WdfCollectionRemove menghapus objek dari koleksi objek tertentu.

Sintaks

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

[in] Collection

Handel ke objek koleksi.

[in] Item

Handel ke objek kerangka kerja yang akan dihapus dari koleksi.

Tidak ada

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Ketika WdfCollectionRemove menghapus objek dari koleksi, WdfCollectionRemove mengurangi jumlah referensi objek.

Untuk informasi selengkapnya tentang koleksi objek, lihat Koleksi Objek Kerangka Kerja.

Contoh kode berikut menghapus objek tertentu dari koleksi objek tertentu.

WdfCollectionRemove(
                    hCollection,
                    hObject
                    );

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Versi UMDF minimum	2.0
Header	wdfcollection.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)