EVT_VHF_CLEANUP コールバック関数 (vhf.h)

  • [アーティクル]

HID ソース ドライバーは、仮想 HID デバイスに割り当てられたドライバーの可能性があるリソースを解放するために、このイベント コールバックを実装します。

構文

EVT_VHF_CLEANUP EvtVhfCleanup;

void EvtVhfCleanup(
  [in] PVOID VhfClientContext
)
{...}

パラメーター

[in] VhfClientContext

ドライバーが VhfCreate への前回の呼び出しで渡した HID ソース ドライバー定義コンテキスト構造へのポインター。仮想 HID デバイスを作成します。

戻り値

なし

解説

仮想 HID デバイスを削除するために、HID ソース ドライバーは VhfDelete を呼び出します。 この呼び出しにより、コールバック関数が HID ソース ドライバーによって実装されている場合、Virtual HID Framework (VHF) によって以前に登録された EvtVhfCleanup が呼び出されます。 ドライバーが Wait を TRUE に設定して VhfDelete を呼び出すと、VhfDelete が返される前に EvtVhfCleanup が呼び出されます。 Wait が FALSE の場合、VhfDelete が返される前または後の VhfDelete が呼び出されると、いつでも呼び出される可能性があります。

この呼び出しにより、HID ソース ドライバーは、そのデバイスが削除されたときに、仮想 HID デバイスに割り当てられたリソースを解放できます。

HID ソース ドライバーは、このコールバック関数が返された後、仮想 HID デバイス ( VhfCreate によって作成) の VHFHANDLE を使用しないでください。 このコールバック関数を呼び出す前に、VHF は非同期操作が保留されていないことを確認します。

要件

要件 値
サポートされている最小のクライアント Windows 10
サポートされている最小のサーバー サポートなし
対象プラットフォーム デスクトップ
Header vhf.h
IRQL <=DISPATCH_LEVEL

こちらもご覧ください

仮想 HID フレームワーク (VHF) を使って HID ソース ドライバーを作成する