Fungsi VhfDelete (vhf.h)

Driver perangkat Sumber HID memanggil metode ini untuk menghapus perangkat VHF.

Sintaks

void VhfDelete(
  [in] VHFHANDLE VhfHandle,
  [in] BOOLEAN   Wait
);

Parameter

[in] VhfHandle

Handel ke perangkat HID virtual yang diterima driver sumber HID Anda dalam panggilan sebelumnya ke VhfCreate.

[in] Wait

TRUE untuk kembali secara sinkron setelah menghapus perangkat. Dalam hal ini, Virtual HID Framework (VHF) tidak kembali sampai perangkat dilaporkan hilang ke fungsi panggilan balik PnP Manager dan EvtVhfCleanup kembali.

FALSE dicadangkan dan tidak boleh diteruskan. Lihat Keterangan untuk informasi selengkapnya.

Nilai kembali

Tidak ada

Keterangan

Driver sumber HID harus berhenti memulai permintaan baru untuk Virtual HID Framework (VHF) tepat sebelum memanggil VhfDelete.

Untuk memanggil VhfDelete secara sinkron, panggil di PASSIVE_LEVEL dengan parameter Tunggu diatur ke TRUE. Dalam hal ini, ia kembali secara sinkron setelah menyelesaikan penghapusan. Jika driver sumber HID telah mendaftarkan fungsi panggilan balik EvtVhfCleanup dengan VHF, ia memanggil panggilan balik tersebut sebelum VhfDelete kembali. Fungsi ini mungkin dipanggil pada utas yang sama.

VhfDelete tidak dapat dipanggil secara asinkron (Parameter tunggu diatur ke FALSE) atau pada IRQL apa pun yang lebih tinggi dari PASSIVE_LEVEL. Melakukannya dapat mengakibatkan perilaku yang tidak ditentukan.

Tidak ada batasan ketika driver KMDF harus memanggil fungsi ini. Disarankan untuk memanggilnya dari fungsi yang cocok dengan panggilan VhfCreate . Misalnya, jika VhfCreate dipanggil dari EvtDriverDeviceAdd, maka panggil VhfDelete secara sinkron dari EvtDeviceCleanupCallback. VhfDelete dapat dipanggil pada VHFHANDLE tanpa sebelumnya disebut VhfStart.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	vhf.h
Pustaka	VhfKm.lib
IRQL	Tunggu TRUE, PASSIVE_LEVEL

Lihat juga

Menulis driver sumber HID dengan menggunakan Virtual HID Framework (VHF)