EVT_WDF_DEVICE_EJECT fungsi panggilan balik (wdfpdo.h)

Artikel
02/27/2024

[Hanya berlaku untuk KMDF]

Fungsi panggilan balik peristiwa EvtDeviceEject driver menangani operasi yang diperlukan untuk mengeluarkan perangkat dari stasiun docking-nya.

Sintaks

EVT_WDF_DEVICE_EJECT EvtWdfDeviceEject;

NTSTATUS EvtWdfDeviceEject(
  [in] WDFDEVICE Device
)
{...}

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

Nilai kembali

Jika operasi berhasil, driver harus mengembalikan STATUS_SUCCESS. Jika tidak, nilai NTSTATUS harus dikembalikan yang NT_SUCCESS evaluasi sebagai FALSE. Jangan kembali STATUS_NOT_SUPPORTED.

Untuk informasi selengkapnya tentang nilai pengembalian, lihat Melaporkan Kegagalan Perangkat.

Keterangan

Driver bus berbasis kerangka kerja dapat menyediakan fungsi panggilan balik EvtDeviceEject . Pengemudi bus harus menyediakan fungsi panggilan balik EvtDeviceEject jika pengemudi harus melakukan operasi yang secara fisik mengeluarkan salah satu perangkat turunan yang dijumlahkan dari stasiun docking perangkat. Untuk mendaftarkan fungsi panggilan balik ini, driver bus harus memanggil WdfPdoInitSetEventCallbacks.

Sebelum memanggil fungsi panggilan balik EvtDeviceEject , kerangka kerja memanggil fungsi panggilan balik EvtDeviceD0Exit dan EvtDeviceReleaseHardware driver.

Jika fungsi panggilan balik EvtDeviceEject driver mengembalikan STATUS_SUCCESS, kerangka kerja memperbarui daftar anak driver untuk menunjukkan bahwa perangkat yang dikeluarkan tidak lagi tersedia. Oleh karena itu driver tidak harus memanggil WdfPdoMarkMissing atau WdfChildListUpdateChildDescriptionAsMissing.

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

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Header	wdfpdo.h (termasuk Wdf.h)
IRQL	PASSIVE_LEVEL

Lihat juga

EvtDeviceSetLock

Bagikan melalui