EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION コールバック関数 (ucxcontroller.h)

UCX は、このコールバック関数を呼び出して、変更が発生したときにクライアント ドライバーが通知を送信する必要があるトランスポート特性の基本設定を指定します。

構文

EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION EvtUcxControllerSetTransportCharacteristicsChangeNotification;

void EvtUcxControllerSetTransportCharacteristicsChangeNotification(
  [in] UCXCONTROLLER UcxController,
  [in] UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS ChangeNotificationFlags
)
{...}

パラメーター

[in] UcxController

UcxControllerCreate メソッドの以前の呼び出しでクライアント ドライバーが受信した UCX コントローラーへのハンドル。

[in] ChangeNotificationFlags

UCX が関心を持つ型トランスポート特性を示すフラグのビットごとのオプション。 フラグは 、UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGSで定義されます。

戻り値

なし

解説

操作が成功した場合、コールバック関数は STATUS_SUCCESS、または NT_SUCCESS(status) が TRUE に等しい別の状態値を返す必要があります。 それ以外の場合は、NT_SUCCESS(status) が FALSE である状態値を返す必要があります。

UCX クライアント ドライバーは、 UcxControllerCreate メソッドを呼び出すことによって、その実装を USB ホスト コントローラー拡張機能 (UCX) に登録します。

効率的な電力消費のために、UCX はこのコールバック関数を呼び出して、UCX が関心のあるトランスポート特性を指定します。

クライアント ドライバーがコントローラーのトランスポート特性の変更を探し続ける場合は、その可能性が高くなります。 これにより、高い電力消費が発生する可能性があり、その変更通知に登録されている USB デバイス ドライバーがない場合は非効率的な場合があります。 電力消費を最適化するために、UCX は、このコールバック関数を呼び出して、クライアント ドライバーに変更が登録されているかどうかをクライアント ドライバーに通知します。 このコールバック関数は、変更通知フラグをパラメーターとして渡します。 フラグが設定されている場合は、少なくとも 1 つのデバイス ドライバーが登録されていることを示します。 フラグが設定されていない場合は、クライアントが登録されていないことを意味するため、コントローラーは電力を最適化できます。

注意

コントローラー ドライバーがこれらのコールバック関数を登録または使用するのは省略可能です。 UCX がクライアントが登録されていないことを示している場合でも、コントローラー ドライバーが変更通知を呼び出すことができます。

要件

要件	値
サポートされている最小のクライアント	Windows 10 バージョン 1709
サポートされている最小のサーバー	Windows Server 2016
対象プラットフォーム	Windows
最小 KMDF バージョン	1.0
最小 UMDF バージョン	2.0
Header	ucxcontroller.h (Ucxclass.h を含む)
IRQL	PASSIVE_LEVEL

こちらもご覧ください

• UcxControllerCreate