Bagikan melalui


Metode IPnpCallback::OnQueryStop (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 OnQueryStop memberi tahu driver sebelum perangkat dihentikan.

Sintaks

HRESULT OnQueryStop(
  [in] IWDFDevice *pWdfDevice
);

Parameter

[in] pWdfDevice

Penunjuk ke antarmuka IWDFDevice untuk objek perangkat perangkat yang akan dihentikan.

Mengembalikan nilai

Jika driver menentukan bahwa perangkat dapat dihentikan, metode panggilan balik OnQueryStop harus mengembalikan S_OK atau kode status lain yang BERHASIL(status) sama dengan TRUE. Jika tidak, kode status harus dikembalikan yang SUCCEEDED(statusnya) sama dengan FALSE. Kode kesalahan HRESULT didefinisikan 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 IPnpCallback saat memanggil metode IWDFDriver::CreateDevice untuk membuat objek perangkat.

Kerangka kerja tidak menyinkronkan fungsi panggilan balik OnQueryStop dengan fungsi panggilan balik PnP dan manajemen daya lainnya.

OnQueryStop tidak dipanggil dalam kerangka kerja versi 1.7 dan yang lebih lama.

Untuk informasi selengkapnya tentang metode panggilan balik OnQueryStop , lihat Manajer PnP Mendistribusikan Ulang Sumber Daya Sistem.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header wudfddi.h (termasuk Wudfddi.h)

Lihat juga

IPnpCallback

IWDFDevice

IWDFDriver::CreateDevice