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
ターゲット プラットフォーム の	ウィンドウズ
最小 KMDF バージョン	1.0
UMDF の最小バージョン を する	2.0
ヘッダー	ucxcontroller.h (Ucxclass.h を含む)
IRQL	PASSIVE_LEVEL

関連項目

• UcxControllerCreate の