Fungsi WdfCollectionGetItem (wdfcollection.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfCollectionGetItem mengembalikan handel ke objek yang terkandung dalam koleksi objek tertentu dan terkait dengan nilai indeks tertentu.

Sintaks

WDFOBJECT WdfCollectionGetItem(
  [in] WDFCOLLECTION Collection,
  [in] ULONG         Index
);

Parameter

[in] Collection

Handel ke objek koleksi.

[in] Index

Nilai indeks berbasis nol yang mengidentifikasi objek dalam koleksi.

Nilai kembali

WdfCollectionGetItem mengembalikan handel objek kerangka kerja, atau NULL jika nilai Indeks tidak valid.

Pemeriksaan bug sistem terjadi jika driver memasok handel objek yang tidak valid.

Keterangan

Nilai indeks mewakili urutan di mana objek ditambahkan ke koleksi. Nilai indeks nol mewakili objek pertama dalam koleksi, nilai indeks satu mewakili objek kedua, dan sebagainya, seperti daftar tertaut. Ketika driver menghapus item i dari koleksi, item i+1 menjadi item i.

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

Contoh

Untuk contoh kode yang menggunakan WdfCollectionGetItem, lihat WdfCollectionGetCount.

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

WdfCollectionGetFirstItem

WdfCollectionGetLastItem