Metode IWDFDriver::CreateWdfObject (wudfddi.h)

  • Artikel

[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 CreateWdfObject membuat objek WDF kustom (atau pengguna) dari objek WDF induk.

Sintaks

HRESULT CreateWdfObject(
  [in, optional] IUnknown   *pCallbackInterface,
  [in, optional] IWDFObject *pParentObject,
  [out]          IWDFObject **ppWdfObject
);

Parameter

[in, optional] pCallbackInterface

Penunjuk ke antarmuka IUnknown yang digunakan kerangka kerja untuk menentukan fungsi panggilan balik peristiwa terkait objek yang berlangganan driver pada objek kustom yang baru dibuat. Parameter ini bersifat opsional. Driver dapat melewati NULL jika driver tidak memerlukan pemberitahuan. Jika driver melewati pointer yang valid, kerangka kerja akan memanggil QueryInterface pada antarmuka IUnknown untuk antarmuka IObjectCleanup . Jika kerangka kerja mendapatkan antarmuka IObjectCleanup driver, kerangka kerja kemudian dapat memanggil metode IObjectCleanup::OnCleanup driver untuk memberi tahu driver bahwa objek kustom dibersihkan.

[in, optional] pParentObject

Penunjuk ke antarmuka IWDFObject untuk objek WDF induk. Jika NULL, objek driver menjadi induk default.

[out] ppWdfObject

Penunjuk ke buffer yang menerima penunjuk ke antarmuka IWDFObject untuk objek WDF yang baru dibuat.

Mengembalikan nilai

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

Keterangan

Driver dapat memanggil CreateWdfObject untuk membuat objek dasar kerangka kerja umum untuk penggunaannya sendiri. Driver dapat mengaitkan memori konteks, menetapkan objek induk, dan mendaftarkan antarmuka IObjectCleanup . Kerangka kerja kemudian memanggil metode IObjectCleanup::OnCleanup untuk membersihkan objek anak.

Jika tidak ada objek induk yang ditentukan pada parameter pParentObject , driver menjadi induk default. Oleh karena itu, ketika objek driver dihapus, kerangka kerja membersihkan objek anak.

Jika objek induk ditetapkan, objek anak dihapus saat objek induk dihapus. Dengan kata lain, masa pakai objek anak terlingkup dalam induk.

Jika driver harus membersihkan objek anak sebelum objek induk dihapus, driver dapat memanggil metode IWDFObject::D eleteWdfObject .

Persyaratan

Persyaratan Nilai
Akhir dukungan Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform Desktop
Versi UMDF minimum 1,5
Header wudfddi.h (termasuk Wudfddi.h)
DLL WUDFx.dll

Lihat juga

IObjectCleanup

IObjectCleanup::OnCleanup

IWDFDriver

IWDFObject

IWDFObject::D eleteWdfObject