Metode IWDFDevice3::CreateWorkItem (wudfddi.h)
[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 |