Fungsi VhfDelete (vhf.h)

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

Sintaksis

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

Parameter

[in] VhfHandle

Handel ke perangkat HID virtual yang diterima driver sumber HID Anda di panggilan sebelumnya untuk VhfBuat.

[in] Wait

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

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

Mengembalikan nilai

Tidak

Komentar

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 ( parameterTunggu 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

Lihat juga

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