Bagikan melalui

Fungsi WdfCollectionRemove (wdfcollection.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfCollectionRemove menghapus objek dari koleksi objek tertentu.

Sintaks

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

Parameter

[in] Collection

Handel ke objek koleksi.

[in] Item

Handel ke objek kerangka kerja yang akan dihapus dari koleksi.

Nilai kembali

Tidak ada

Keterangan

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

Contoh kode berikut menghapus objek tertentu dari koleksi objek tertentu.

WdfCollectionRemove(
                    hCollection,
                    hObject
                    );

Persyaratan

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)

Lihat juga

WdfCollectionRemoveItem