Metode IPnpCallbackHardware2::OnReleaseHardware (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 OnReleaseHardware melakukan operasi yang diperlukan ketika perangkat tidak lagi dapat diakses.
Sintaks
HRESULT OnReleaseHardware(
[in] IWDFDevice3 *pWdfDevice,
[in] IWDFCmResourceList *pWdfResourcesTranslated
);
Parameter
[in] pWdfDevice
Penunjuk ke antarmuka IWDFDevice3 untuk objek perangkat kerangka kerja.
[in] pWdfResourcesTranslated
Penunjuk ke antarmuka IWDFCmResourceList untuk objek daftar sumber daya kerangka kerja yang mengidentifikasi sumber daya perangkat keras yang diterjemahkan yang telah ditetapkan manajer Plug and Play ke perangkat.
Nilai kembali
OnReleaseHardware mengembalikan S_OK jika operasi berhasil. Jika tidak, metode ini mengembalikan salah satu kode kesalahan yang ditentukan dalam Winerror.h. Jangan mengembalikan HRESULT_FROM_NT(STATUS_NOT_SUPPORTED).
Keterangan
Driver mendaftarkan antarmuka IPnpCallbackHardware2 saat driver memanggil metode IWDFDriver::CreateDevice untuk membuat objek perangkat.
Metode OnReleaseHardware harus membebaskan sumber daya yang dialokasikan selama panggilan ke metode IPnpCallbackHardware2::OnPrepareHardware driver, terlepas dari apakah OnPrepareHardware berhasil atau gagal. Dengan demikian, OnReleaseHardware harus dapat menangani pembersihan sumber daya parsial.
Untuk informasi tentang menghapus objek interupsi, lihat Menghapus Objek Interupsi.
Untuk informasi tentang mengurai sumber daya perangkat keras, lihat Menemukan dan Memetakan Sumber Daya Perangkat Keras di Driver UMDF.
Contoh
Lihat contoh kode di IWDFDevice3::MapIoSpace.
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 |