Metode IWDFObject::D eleteWdfObject (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 DeleteWdfObject menghapus objek Microsoft Windows Driver Frameworks (WDF) yang dibuat sebelumnya.

Sintaks

HRESULT DeleteWdfObject();

Mengembalikan nilai

DeleteWdfObject mengembalikan S_OK jika operasi berhasil. Jika tidak, metode ini mengembalikan HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) atau salah satu kode kesalahan lainnya yang ditentukan dalam Winerror.h.

Keterangan

Pengandar tidak dapat menghapus beberapa objek WDF. Misalnya, driver tidak dapat menghapus objek perangkat kerangka kerja karena kerangka kerja memiliki dan mengontrol objek perangkat. Untuk informasi selengkapnya tentang hierarki objek WDF, lihat Hierarki Objek Kerangka Kerja.

Driver biasanya hanya menghapus objek WDF yang dibuat dan dimilikinya. Untuk informasi selengkapnya tentang menghapus objek kerangka kerja, lihat Mengelola Masa Pakai Objek.

Namun, ketika objek induk dihapus, semua objek anak akan dihapus secara otomatis. Misalnya, jika driver yang disebut IWDFDevice::CreateIoQueue untuk membuat objek antrean I/O, antrean I/O yang baru dibuat menjadi anak dari objek perangkat. Objek antrean I/O kemudian dihapus secara otomatis ketika objek perangkat dihapus tanpa driver secara eksplisit memanggil DeleteWdfObject.

Contoh

Untuk contoh kode tentang cara menggunakan metode DeleteWdfObject , lihat IWDFDevice::SetPnpState.

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

IWDFDevice::CreateIoQueue

IWDFObject