WUDF_INTERRUPT_ENABLE fungsi panggilan balik (wudfinterrupt.h)

  • Artikel

Peringatan

UMDF 2 adalah versi terbaru UMDF dan supersedes UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.

Fungsi panggilan balik peristiwa OnInterruptEnable driver memungkinkan gangguan perangkat keras tertentu.

Sintaks

WUDF_INTERRUPT_ENABLE WudfInterruptEnable;

HRESULT WudfInterruptEnable(
  [in] IWDFInterrupt *Interrupt,
  [in] IWDFDevice *AssociatedDevice
)
{...}

Parameter

[in] Interrupt

Penunjuk ke antarmuka IWDFInterrupt .

[in] AssociatedDevice

Pointer ke antarmuka IWDFDevice yang digunakan driver untuk memanggil CreateInterrupt.

Nilai kembali

Fungsi panggilan balik harus mengembalikan S_OK jika operasi berhasil. Jika tidak, panggilan balik harus mengembalikan salah satu kode kesalahan yang ditentukan dalam Winerror.h.

Keterangan

Untuk mendaftarkan fungsi panggilan balik OnInterruptEnable , driver Anda harus menempatkan alamat fungsi panggilan balik dalam struktur WUDF_INTERRUPT_CONFIG sebelum memanggil IWDFDevice::CreateInterrupt.

Kerangka kerja memanggil fungsi panggilan balik OnInterruptEnable driver setiap kali perangkat memasuki status berfungsi (D0). Selain itu, driver dapat menyebabkan kerangka kerja memanggil fungsi panggilan balik OnInterruptEnable dengan memanggil IWDFInterrupt::Enable.

Sebelum memanggil fungsi panggilan balik OnInterruptEnable , kerangka kerja memperoleh kunci interupsi mode pengguna.

Setelah memanggil fungsi panggilan balik OnInterruptEnable , kerangka kerja memanggil fungsi panggilan balik peristiwa OnD0EntryPostInterruptsEnabled driver.

Untuk informasi selengkapnya tentang penanganan gangguan pada driver UMDF, lihat Mengakses Perangkat Keras dan Menangani Gangguan.

Contoh

Jenis fungsi dideklarasikan dalam Wudfinterrupt.h, sebagai berikut.

typedef
__drv_functionClass(WUDF_INTERRUPT_ENABLE)
HRESULT
WUDF_INTERRUPT_ENABLE(
    _In_
    IWDFInterrupt* Interrupt,
    _In_
    IWDFDevice* AssociatedDevice
    );

typedef WUDF_INTERRUPT_ENABLE *PFN_WUDF_INTERRUPT_ENABLE;

Untuk menentukan fungsi panggilan balik OnInterruptEnable yang bernama MyInterruptEnable, Anda harus terlebih dahulu memberikan deklarasi fungsi yang diperlukan SDV dan alat verifikasi lainnya, sebagai berikut:

WUDF_INTERRUPT_ENABLE  MyInterruptEnable;

Kemudian, terapkan fungsi panggilan balik Anda sebagai berikut:

HRESULT
  MyInterruptEnable (
    IN IWDFInterrupt* pInterrupt,
    IN IWDFDevice*  pAssociatedDevice
    )
  {…}

Persyaratan

Persyaratan Nilai
Akhir dukungan Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform Desktop
Versi UMDF minimum 1.11
Header wudfinterrupt.h

Lihat juga