Fungsi WdfCollectionGetFirstItem (wdfcollection.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfCollectionGetFirstItem mengembalikan handel ke objek pertama yang ada dalam koleksi objek.

Sintaks

WDFOBJECT WdfCollectionGetFirstItem(
  [in] WDFCOLLECTION Collection
);

Parameter

[in] Collection

Handel ke objek koleksi.

Nilai kembali

WdfCollectionGetFirstItem mengembalikan handel ke objek yang saat ini berada di depan daftar objek koleksi yang ditentukan, atau NULL jika daftar kosong.

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

Keterangan

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

Contoh

Contoh kode berikut menghapus setiap item dari koleksi dan menghapus setiap objek item.

while ((subRequest = WdfCollectionGetFirstItem(hCollection)) != NULL) {
    WdfCollectionRemoveItem(
                            hCollection,
                            0
                            );
    WdfObjectDelete(subRequest);
}

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

WdfCollectionGetItem

WdfCollectionGetLastItem