EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED fungsi panggilan balik (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Fungsi panggilan balik peristiwa EvtDeviceD0ExitPreInterruptsDisabled driver melakukan operasi khusus perangkat yang diperlukan sebelum driver menonaktifkan gangguan perangkat keras.

Sintaks

EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED EvtWdfDeviceD0ExitPreInterruptsDisabled;

NTSTATUS EvtWdfDeviceD0ExitPreInterruptsDisabled(
  [in] WDFDEVICE Device,
  [in] WDF_POWER_DEVICE_STATE TargetState
)
{...}

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] TargetState

Enumerator jenis WDF_POWER_DEVICE_STATE yang mengidentifikasi status daya perangkat yang akan dimasukkan perangkat.

Nilai kembali

Jika fungsi panggilan balik EvtDeviceD0ExitPreInterruptsDisabled tidak mengalami kesalahan, fungsi tersebut harus mengembalikan STATUS_SUCCESS atau nilai status lain yang NT_SUCCESS(statusnya) sama dengan TRUE. Jika tidak, nilai status harus dikembalikan yang NT_SUCCESS(status) sama dengan FALSE.

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

Keterangan

Untuk mendaftarkan fungsi panggilan balik EvtDeviceD0ExitPreInterruptsDisabled , driver harus memanggil WdfDeviceInitSetPnpowerEventCallbacks.

Fungsi panggilan balik EvtDeviceD0ExitPreInterruptsDisabled dipanggil di IRQL = PASSIVE_LEVEL, sebelum kerangka kerja memanggil fungsi panggilan balik EvtInterruptDisable driver. Driver dapat menyediakan fungsi ini jika harus melakukan operasi khusus perangkat sebelum menonaktifkan gangguan, jika operasi tersebut tidak boleh dilakukan di IRQL = DIRQL dalam fungsi panggilan balik EvtInterruptDisable .

Untuk informasi selengkapnya tentang kapan kerangka kerja memanggil fungsi panggilan balik ini, lihat Skenario Manajemen PnP dan Power.

Untuk informasi selengkapnya tentang penanganan gangguan, lihat Menangani Gangguan Perangkat Keras.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfdevice.h (termasuk Wdf.h)
IRQL PASSIVE_LEVEL (lihat bagian Keterangan)

Lihat juga

EvtDeviceD0EntryPostInterruptsEnabled