EVT_WDF_IO_TARGET_REMOVE_COMPLETE コールバック関数 (wdfiotarget.h)

[KMDF と UMDF に適用]

ドライバーの EvtIoTargetRemoveComplete イベント コールバック関数は、指定されたリモート I/O ターゲットの削除が完了したときに操作を実行します。

構文

EVT_WDF_IO_TARGET_REMOVE_COMPLETE EvtWdfIoTargetRemoveComplete;

void EvtWdfIoTargetRemoveComplete(
  [in] WDFIOTARGET IoTarget
)
{...}

パラメーター

[in] IoTarget

I/O ターゲット オブジェクトへのハンドル。

戻り値

なし

解説

EvtIoTargetRemoveComplete コールバック関数を登録するには、コールバック関数のアドレスを I/O ターゲットの WDF_IO_TARGET_OPEN_PARAMS 構造体に配置します。

フレームワークは、ドライバーの EvtIoTargetQueryRemove コールバック関数がSTATUS_SUCCESSを返した後、またはデバイスが予期せず削除された (突然削除された) 後に、ドライバーの EvtIoTargetRemoveComplete コールバック関数を呼び出します。

ドライバーの EvtIoTargetRemoveComplete コールバック関数は 、WdfIoTargetClose を呼び出してリモート I/O ターゲットを完全に閉じる必要があります。 ターゲット デバイスが削除されたため、 EvtIoTargetRemoveComplete コールバック関数は、ドライバーがターゲットを開いたときに割り当てたシステム リソースの解放など、必要な追加のターゲット削除操作も実行する必要があります。

EvtIoTargetRemoveComplete コールバック関数は省略可能です。 ドライバーがこのコールバック関数を指定しない場合、フレームワークは I/O ターゲットを完全に閉じます。

EvtIoTargetRemoveComplete コールバック関数の詳細については、「一般的な I/O ターゲットの状態の制御」を参照してください。

要件

こちらもご覧ください

EvtIoTargetQueryRemove

EvtIoTargetRemoveCanceled

WDF_IO_TARGET_OPEN_PARAMS

WdfIoTargetClose