VhfDelete 函式 （vhf.h）

HID 來源裝置驅動程式會呼叫此方法來刪除 VHF 裝置。

語法

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

參數

[in] VhfHandle

您 HID 來源驅動程式在先前呼叫 VhfCreate中收到的虛擬 HID 裝置句柄。

[in] Wait

TRUE 會在刪除裝置之後同步傳回。 在此情況下，虛擬 HID 架構 （VHF） 不會傳回，直到裝置回報為 PnP 管理員遺失，EvtVhfCleanup 回呼函式才會傳回。

FALSE 是保留的，不應傳遞。 如需詳細資訊，請參閱。

傳回值

沒有

言論

在呼叫 VhfDelete之前，HID 來源驅動程式必須先停止起始虛擬 HID Framework （VHF） 的新要求。

若要以同步方式呼叫 VhfDelete，請在 PASSIVE_LEVEL呼叫它，並將 Wait 參數設定為 TRUE。 在此情況下，它會在完成刪除之後同步傳回。 如果 HID 來源驅動程式已向 VHF 註冊 EvtVhfCleanup 回呼函式，則會在 VhfDelete 傳回之前叫用該回呼。 函式可能會在相同的線程上叫用。

VhfDelete 無法以異步方式呼叫（Wait 參數設定為 FALSE）或高於 PASSIVE_LEVEL 的任何 IRQL。 這樣做可能會導致未定義的行為。

KMDF 驅動程式應該呼叫此函式時，沒有任何限制。 建議從符合 VhfCreate 呼叫的函式呼叫它。 例如，如果從 EvtDriverDeviceAdd呼叫 VhfCreate，則從 EvtDeviceCleanupCallback同步呼叫 VhfDelete 。 VhfDelete 可以在 VHFHANDLE 上呼叫，而不需要先前呼叫 VhfStart。

要求

另請參閱

使用虛擬 HID 架構 （VHF） 撰寫 HID 來源驅動程式