Fungsi WdfChildListRequestChildEject (wdfchildlist.h)

[Berlaku untuk KMDF saja]

Metode WdfChildListRequestChildEject menginformasikan kerangka kerja bahwa perangkat tertentu akan dikeluarkan dari stasiun docking-nya.

Sintaks

BOOLEAN WdfChildListRequestChildEject(
  [in] WDFCHILDLIST                                 ChildList,
  [in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);

Parameter

[in] ChildList

Handel ke objek daftar anak.

[in] IdentificationDescription

Penunjuk ke struktur WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER yang dialokasikan penelepon.

Nilai kembali

WdfChildListRequestChildEject mengembalikan TRUE jika operasi berhasil. Jika parameter input tidak valid, atau jika kerangka kerja tidak dapat menemukan perangkat dalam daftar anak, metode mengembalikan FALSE.

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

Keterangan

Pengemudi bus dapat memanggil WdfChildListRequestChildEject atau WdfPdoRequestEject untuk melaporkan bahwa driver telah mendeteksi upaya untuk mengeluarkan salah satu perangkat turunan yang dijumlahkan dari stasiun docking perangkat. Misalnya, driver mungkin mendeteksi bahwa pengguna telah mendorong tombol keluarkan.

Jika driver menggunakan enumerasi bus dinamis dan jika deskripsi identifikasi perangkat tersedia, driver dapat memanggil WdfChildListRequestChildEject. Jika objek perangkat kerangka kerja untuk PDO perangkat tersedia, driver dapat memanggil WdfPdoRequestEject.

Parameter IdentificationDescription metode WdfChildListRequestChildEject mengidentifikasi perangkat yang sedang dikeluarkan. Perangkat harus menjadi anggota daftar anak yang diwakili parameter ChildList .

Kerangka kerja menggunakan deskripsi identifikasi untuk menemukan perangkat dalam daftar anak.

Untuk informasi selengkapnya tentang daftar anak, lihat Enumerasi Dinamis.

Untuk informasi selengkapnya tentang perangkat yang dapat dikeluarkan, lihat Mendukung Perangkat yang Dapat Dikeluarkan.

Contoh

Untuk contoh kode yang menggunakan WdfChildListRequestChildEject, lihat WdfChildListRetrieveNextDevice.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Header	wdfchildlist.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

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WdfPdoRequestEject