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

[KMDF と UMDF に適用]

ドライバーの EvtDeviceSelfManagedIoInit イベント コールバック関数は、デバイスの自己管理 I/O 操作を初期化して開始します。

構文

EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT EvtWdfDeviceSelfManagedIoInit;

NTSTATUS EvtWdfDeviceSelfManagedIoInit(
  [in] WDFDEVICE Device
)
{...}

パラメーター

[in] Device

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

戻り値

EvtDeviceSelfManagedIoInit コールバック関数でエラーが発生しない場合は、STATUS_SUCCESSを返すか、NT_SUCCESS(状態) が TRUE 等しい別の状態値を返す必要があります。 それ以外の場合は、NT_SUCCESS(状態) が FALSE 等しい状態値を返す必要があります。 NT_SUCCESS(状態) が FALSE 等しい場合、フレームワークはデバイスを起動しません。

NT_SUCCESS(status) が FALSE 等しい場合、フレームワークはドライバーの EvtDeviceSelfManagedIoFlush を呼び出し、EvtDeviceSelfManagedIoCleanup コールバック関数を します。

このコールバック関数の戻り値の詳細については、「Reporting Device Failures」を参照してください。

備考

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

ドライバーが evtDeviceSelfManagedIoInit コールバック関数 登録している場合、フレームワークは、ドライバーの EvtDeviceD0Entry コールバック関数を初めて呼び出した後、デバイスごとに 1 回呼び出します。 デバイスを削除して再接続するか、ドライバーを再読み込みしない限り、フレームワークは、そのデバイスの EvtDeviceSelfManagedIoInit コールバック関数を再度呼び出しません。

EvtDeviceSelfManagedIoInit コールバック関数は、ドライバーがデバイスに対して処理する自己管理 I/O 操作を初期化して開始する必要があります。

フレームワークがこのコールバック関数を呼び出すタイミングの詳細については、「PnP と電源管理のシナリオ を参照してください。

このコールバック関数を提供するドライバーの詳細については、「Self-Managed I/Oの使用」を参照してください。

必要条件

要件	価値
ターゲット プラットフォーム の	万国
最小 KMDF バージョン	1.0
UMDF の最小バージョン を する	2.0
ヘッダー	wdfdevice.h (Wdf.h を含む)
IRQL	PASSIVE_LEVEL

関連項目

EvtDeviceSelfManagedIoCleanup の

EvtDeviceSelfManagedIoFlush の

EvtDeviceSelfManagedIoRestart の

EvtDeviceSelfManagedIoSuspend の