VhfDelete 函式 (vhf.h)
HID 來源設備驅動器會呼叫這個方法來刪除 VHF 裝置。
語法
void VhfDelete(
[in] VHFHANDLE VhfHandle,
[in] BOOLEAN Wait
);
參數
[in] VhfHandle
您 HID 來源驅動程式在先前呼叫 VhfCreate 中收到的虛擬 HID 裝置句柄。
[in] Wait
TRUE 是表示 在刪除裝置之後同步傳回。 在此情況下，虛擬 HID Framework (VHF) 不會傳回，直到裝置回報為 PnP 管理員遺失， 而 EvtVhfCleanup 回 呼函式才會傳回。
FALSE 是保留的，不應該傳遞。 如需詳細資訊，請參閱「備註」。
傳回值
無
備註
HID 來源驅動程式必須停止起始虛擬 HID Framework (VHF) 的新要求，再呼叫 VhfDelete。
若要以同步方式呼叫 VhfDelete，請在PASSIVE_LEVEL呼叫 VhfDelete ，並將 Wait 參數設定為 TRUE。 在此情況下，它會在完成刪除之後同步傳回。 如果 HID 來源驅動程式已向 VHF 註冊 EvtVhfCleanup 回呼函式，它會在 VhfDelete 傳回之前叫用該回呼。 函式可能會在相同的線程上叫用。
VhfDelete 無法以異步方式呼叫， (Wait 參數設定為 FALSE) 或高於 PASSIVE_LEVEL 的任何 IRQL。 這樣做可能會導致未定義的行為。
KMDF 驅動程式應該呼叫此函式時沒有任何限制。 建議從符合 VhfCreate 呼叫的函式呼叫它。 例如，如果從 EvtDriverDeviceAdd 呼叫 VhfCreate，則從 EvtDeviceCleanupCallback 同步呼叫 VhfDelete。 VhfDelete 可以在 VHFHANDLE 上呼叫，而不需要先前稱為 VhfStart。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | vhf.h |
| 程式庫 | VhfKm.lib |
| IRQL | 等候為 TRUE，PASSIVE_LEVEL |