UdecxWdfDeviceNeedsReset 関数 (udecxwdfdevice.h)

USB デバイス エミュレーション クラス拡張機能 (UdeCx) に、デバイスにリセット操作が必要であることを通知します。

構文

NTSTATUS UdecxWdfDeviceNeedsReset(
  [In] WDFDEVICE                   UdeWdfDevice,
  [In] UDECX_WDF_DEVICE_RESET_TYPE ResetType
);

パラメーター

[In] UdeWdfDevice

USB デバイスを表すフレームワーク デバイス オブジェクトへのハンドル。 クライアント ドライバーは、UdecxWdfDeviceAddUsbDeviceEmulationをする前の呼び出しでこのオブジェクトを初期化しました。

[In] ResetType

リセットの種類を示す UDECX_WDF_DEVICE_RESET_TYPE型の値。 現時点では、UdecxWdfDeviceResetAttemptPlatformLevelDeviceReset のみがサポートされています。

戻り値

この関数は、操作が成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合は、適切な NTSTATUS エラー コードを返します。

備考

既存のリセット操作が進行中の場合、関数はSTATUS_DEVICE_BUSY エラーで失敗します。 現時点では、UdecxWdfDeviceResetAttemptPlatformLevelDeviceReset のみがサポートされることに注意してください。 UdecxWdfDeviceResetAttemptFunctionLevelDeviceReset はサポートされていません。

必要条件

関連項目

UDECX_WDF_DEVICE_RESET_TYPE