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 つのデバイス ドライバーが登録されていることを示します。 フラグが設定されていない場合は、クライアントが登録されていないことを意味するため、コントローラーは電力を最適化できます。

要件

こちらもご覧ください

• UcxControllerCreate