Metode IWDFDevice3::CreateWorkItem (wudfddi.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 Mulai menggunakan UMDF.]

Metode CreateWorkItem membuat objek item kerja kerangka kerja, yang kemudian dapat ditambahkan ke antrean item kerja kerangka kerja.

Sintaks

HRESULT CreateWorkItem(
  [in]           PWUDF_WORKITEM_CONFIG pConfig,
  [in, optional] IWDFObject            *pParentObject,
  [out]          IWDFWorkItem          **ppWorkItem
);

Parameter

[in] pConfig

Penunjuk ke struktur WUDF_WORKITEM_CONFIG yang dialokasikan pemanggil yang harus sudah diinisialisasi driver dengan memanggil WUDF_WORKITEM_CONFIG_INIT.

[in, optional] pParentObject

Penunjuk ke antarmuka objek induk atau NULL.

[out] ppWorkItem

Penunjuk ke buffer yang menerima penunjuk ke antarmuka IWDFWorkItem untuk objek WorkItem baru.

Nilai kembali

Metode mengembalikan S_OK jika operasi berhasil. Jika tidak, metode ini mengembalikan salah satu kode kesalahan yang ditentukan dalam Winerror.h.

Keterangan

Jika Anda menentukan objek induk, kerangka kerja secara otomatis menghapus item kerja saat objek induk dihapus. Atau, driver dapat memanggil IWDFObject::D eleteWdfObject untuk menghapus item kerja. Driver tidak boleh menghapus item kerja dalam fungsi panggilan balik OnWorkItem-nya .

Untuk informasi selengkapnya, lihat Menggunakan Item Kerja.

Contoh

WUDF_WORKITEM_CONFIG config;
        
WUDF_WORKITEM_CONFIG_INIT(&config, OnWorkItem); 
hr = m_IWdfDevice3->CreateWorkItem(&config,
                                   m_IWdfDevice3,   
                                   &m_WorkItem);

Persyaratan

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