Metode IPnpCallbackHardware::OnReleaseHardware (wudfddi.h)

Artikel
03/08/2023

[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 memberi tahu driver untuk melakukan operasi yang diperlukan ketika perangkat keras yang ditentukan tidak lagi dapat diakses.

Sintaks

HRESULT OnReleaseHardware(
  [in] IWDFDevice *pWdfDevice
);

Parameter

[in] pWdfDevice

Penunjuk ke antarmuka IWDFDevice untuk objek perangkat perangkat yang tidak lagi dapat diakses.

Mengembalikan nilai

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).

Metode ini harus menggunakan makro HRESULT_FROM_NT untuk mengembalikan nilai HRESULT tertentu untuk mengembalikan status ke klien mode kernel. Untuk informasi selengkapnya, lihat Mendukung Klien mode Kernel.

Keterangan

Driver mendaftarkan antarmuka IPnpCallbackHardware saat driver memanggil metode IWDFDriver::CreateDevice untuk membuat objek perangkat.

Metode OnReleaseHardware harus membebaskan sumber daya yang dialokasikan selama panggilan ke metode IPnpCallbackHardware::OnPrepareHardware driver apakah OnPrepareHardware berhasil atau gagal. Oleh karena itu, OnReleaseHardware harus dapat menangani pembersihan sumber daya parsial.

Untuk informasi selengkapnya, lihat Menemukan dan Memetakan Sumber Daya Perangkat Keras di Driver UMDF.