WUDF_INTERRUPT_DISABLE fungsi panggilan balik (wudfinterrupt.h)

Artikel
02/27/2024

Peringatan

UMDF 2 adalah versi terbaru UMDF dan pengganti 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 Memulai UMDF.

Fungsi panggilan balik peristiwa OnInterruptDisable driver menonaktifkan gangguan perangkat keras tertentu.

Sintaks

WUDF_INTERRUPT_DISABLE WudfInterruptDisable;

HRESULT WudfInterruptDisable(
  [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

OnInterruptDisable 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 OnInterruptDisable , driver Anda harus menempatkan alamat fungsi panggilan balik dalam struktur WUDF_INTERRUPT_CONFIG sebelum memanggil IWDFDevice::CreateInterrupt.

Kerangka kerja memanggil fungsi panggilan balik OnInterruptDisable driver setiap kali perangkat meninggalkan status berfungsi (D0). Selain itu, driver dapat menyebabkan kerangka kerja memanggil fungsi panggilan balik OnInterruptDisable dengan memanggil IWDFInterrupt::D isable.

Sebelum memanggil fungsi panggilan balik OnInterruptDisable , kerangka kerja memanggil fungsi panggilan balik peristiwa OnD0ExitPreInterruptsDisabled driver dan memperoleh kunci interupsi mode pengguna.

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

Contoh

Jenis fungsi dideklarasikan dalam Wudfinterrupt.h, sebagai berikut.

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

typedef WUDF_INTERRUPT_DISABLE *PFN_WUDF_INTERRUPT_DISABLE;

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

WUDF_INTERRUPT_DISABLE  MyInterruptDisable;

Kemudian, terapkan fungsi panggilan balik Anda sebagai berikut:

HRESULT
  MyInterruptDisable (
    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

Bagikan melalui