WUDF_WORKITEM_FUNCTION fungsi panggilan balik (wudfworkitem.h)

Artikel
03/05/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 Mulai menggunakan UMDF.]

Fungsi panggilan balik peristiwa OnWorkItem driver melakukan pekerjaan yang terkait dengan item kerja tertentu.

Sintaks

WUDF_WORKITEM_FUNCTION WudfWorkitemFunction;

void WudfWorkitemFunction(
  [in] IWDFWorkItem *pWorkItem
)
{...}

Parameter

[in] pWorkItem

Penunjuk ke antarmuka IWDFWorkItem .

Nilai kembali

Tidak ada

Keterangan

Untuk mendaftarkan fungsi panggilan balik OnWorkItem , driver Anda harus menempatkan alamat fungsi panggilan balik dalam struktur WUDF_WORKITEM_CONFIG sebelum memanggil IWDFDevice3::CreateWorkItem.

Biasanya, fungsi panggilan balik OnWorkItem driver melakukan tugas yang ditentukan oleh informasi yang disimpan driver dalam memori konteks objek item kerja.

Driver tidak boleh memanggil IWDFObject::D eleteWdfObject dari fungsi panggilan balik OnWorkItem .

Untuk informasi selengkapnya, lihat Menggunakan Item Kerja.

Contoh

Jenis fungsi dideklarasikan dalam Wudfworkitem.h, sebagai berikut.

typedef
VOID
WUDF_WORKITEM_FUNCTION(
    _In_
    IWDFWorkItem* pWorkItem
    );

typedef WUDF_WORKITEM_FUNCTION *PFN_WUDF_WORKITEM;

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

WUDF_WORKITEM_FUNCTION  MyWorkItem;

Kemudian, terapkan fungsi panggilan balik Anda sebagai berikut:

VOID
  MyWorkItem (
   _In_
    IWDFWorkItem* pWorkItem
    )
  {…}

Persyaratan

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

Lihat juga

IWDFDevice3::CreateWorkItem

IWDFObject::D eleteWdfObject

WUDF_WORKITEM_CONFIG

Bagikan melalui