EVT_WDF_DEVICE_SET_LOCK fungsi panggilan balik (wdfpdo.h)

  • Artikel

[Hanya berlaku untuk KMDF]

Fungsi panggilan balik peristiwa EvtDeviceSetLock driver mengunci perangkat yang ditentukan sehingga tidak dapat dikeluarkan, atau membuka kunci perangkat sehingga dapat dikeluarkan.

Sintaks

EVT_WDF_DEVICE_SET_LOCK EvtWdfDeviceSetLock;

NTSTATUS EvtWdfDeviceSetLock(
  [in] WDFDEVICE Device,
  [in] BOOLEAN IsLocked
)
{...}

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] IsLocked

Nilai Boolean yang menunjukkan apakah driver harus mengunci atau membuka kunci perangkat. Jika TRUE, driver harus mengunci perangkat sehingga tidak dapat dikeluarkan. Jika FALSE, driver harus membuka kunci perangkat sehingga dapat dikeluarkan.

Nilai kembali

Jika driver berhasil mengunci atau membuka kunci perangkat, driver harus mengembalikan STATUS_SUCCESS. Jika tidak, nilai NTSTATUS harus dikembalikan yang NT_SUCCESS evaluasi sebagai FALSE.

Untuk informasi selengkapnya tentang nilai pengembalian fungsi panggilan balik ini, lihat Melaporkan Kegagalan Perangkat.

Keterangan

Driver bus berbasis kerangka kerja dapat menyediakan fungsi panggilan balik EvtDeviceSetLock . Untuk mendaftarkan fungsi panggilan balik ini, driver bus memanggil WdfPdoInitSetEventCallbacks.

Kerangka kerja memanggil fungsi panggilan balik EvtDeviceSetLock driver ketika manajer PnP meminta driver bus untuk mengunci atau membuka salah satu perangkat anak yang dijumlahkan.

Tidak menerapkan fungsi panggilan balik EvtDeviceSetLock untuk perangkat setara dengan mengembalikan nilai NTSTATUS yang dievaluasi sebagai FALSE.

Untuk informasi selengkapnya tentang nilai pengembalian, 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

EvtDeviceEject