Fungsi WdfFdoLockStaticChildListForIteration (wdffdo.h)

  • Artikel

[Berlaku untuk KMDF saja]

Metode WdfFdoLockStaticChildListForIteration menyiapkan kerangka kerja untuk mengambil item dari daftar turunan statis milik perangkat induk tertentu.

Sintaks

void WdfFdoLockStaticChildListForIteration(
  [in] WDFDEVICE Fdo
);

Parameter

[in] Fdo

Handel ke objek perangkat kerangka kerja yang mewakili perangkat induk.

Nilai kembali

Tidak ada

Keterangan

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

Pengemudi bus yang menggunakan enumerasi bus statis dapat memanggil WdfFdoLockStaticChildListForIteration.

Setelah memanggil WdfFdoLockStaticChildListForIteration, driver dapat berulang kali memanggil WdfFdoRetrieveNextStaticChild untuk mendapatkan informasi tentang setiap perangkat anak dalam daftar anak.

Setelah driver selesai memanggil WdfFdoRetrieveNextStaticChild, driver harus memanggil WdfFdoUnlockStaticChildListFromIteration.

Jika driver membuat perubahan pada daftar anak setelah memanggil WdfFdoLockStaticChildListForIteration, kerangka kerja menyimpan semua perubahan dan memberi tahu manajer Plug and Play (PnP) tentang perubahan saat driver memanggil WdfFdoUnlockStaticChildListFromIteration.

Driver dapat menumpuk panggilan ke WdfFdoLockStaticChildListForIteration dan WdfFdoUnlockStaticChildListFromIteration. Jika driver menumpuk panggilan ke metode ini, kerangka kerja menyimpan semua perubahan hingga panggilan terakhir ke WdfFdoUnlockStaticChildListFromIteration.

Untuk informasi selengkapnya tentang daftar turunan statis, lihat Enumerasi Statis.

Contoh

Untuk contoh kode yang menggunakan WdfFdoLockStaticChildListForIteration, lihat WdfFdoRetrieveNextStaticChild.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Header wdffdo.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL <= DISPATCH_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

WdfFdoUnlockStaticChildListFromIteration