Bagikan melalui


Fungsi WdfCollectionRemoveItem (wdfcollection.h)

[Berlaku untuk KMDF dan UMDF]

Metode WdfCollectionRemoveItem menghapus objek tertentu dari koleksi objek, berdasarkan nilai indeks tertentu.

Sintaks

void WdfCollectionRemoveItem(
  [in] WDFCOLLECTION Collection,
  [in] ULONG         Index
);

Parameter

[in] Collection

Handel ke objek koleksi.

[in] Index

Indeks berbasis nol yang mengidentifikasi objek yang akan dihapus.

Nilai kembali

Tidak ada

Keterangan

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

Nilai indeks mewakili urutan penambahan objek ke koleksi. Nilai indeks nol mewakili objek pertama yang ditambahkan ke koleksi, nilai indeks satu mewakili objek kedua, dan sebagainya.

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

Untuk informasi selengkapnya tentang kumpulan objek, lihat Kumpulan Objek Kerangka Kerja

Contoh

Untuk contoh kode yang menggunakan WdfCollectionRemoveItem, lihat WdfCollectionGetFirstItem.

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

WdfCollectionRemove