EVT_WDF_DEVICE_SURPRISE_REMOVAL コールバック関数 (wdfdevice.h)

  • [アーティクル]

[KMDF と UMDF に適用]

ドライバーの EvtDeviceSurpriseRemoval イベント コールバック関数は、デバイスが予期せずシステムから削除された後、またはドライバーが デバイスが失敗したことを報告した後に必要な操作を実行します。

構文

EVT_WDF_DEVICE_SURPRISE_REMOVAL EvtWdfDeviceSurpriseRemoval;

void EvtWdfDeviceSurpriseRemoval(
  [in] WDFDEVICE Device
)
{...}

パラメーター

[in] Device

フレームワーク デバイス オブジェクトへのハンドル。

戻り値

なし

解説

EvtDeviceSurpriseRemoval コールバック関数を登録するには、ドライバーで WdfDeviceInitSetPnpPowerEventCallbacks を呼び出す必要があります。

フレームワークは 、EvtDeviceSurpriseRemoval コールバック関数を他の PnP および電源管理コールバック関数と同期しません。 フレームワークがドライバーのイベント コールバック関数の実行を同期する方法については、「 自動同期の使用」を参照してください。

フレームワークがこのコールバック関数を呼び出すタイミングの詳細と、同期の問題の詳細については、「 A User Unplugs a Device」を参照してください。

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
最小 UMDF バージョン 2.0
Header wdfdevice.h (Wdf.h を含む)
IRQL PASSIVE_LEVEL