UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS union (ucxcontroller.h)

Defines flags for the transport characteristics changes. This structure is used in the EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION callback function.

Syntax

typedef union _UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS {
  ULONG  AsUlong32;
  struct {
    ULONG CurrentRoundtripLatencyChanged : 1;
    ULONG CurrentTotalBandwidthChanged : 1;
  } Flags;
  struct {
    ULONG CurrentRoundtripLatencyChanged : 1;
    ULONG CurrentTotalBandwidthChanged : 1;
  };
} UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS;

Members

AsUlong32

Reserved.

Flags

Flags.CurrentRoundtripLatencyChanged

Flags.CurrentTotalBandwidthChanged

CurrentRoundtripLatencyChanged

Contains the current round-trip delay in milliseconds from the time a non-isochronous transfer is received by the USB driver stack to the time that the transfer is completed.

For MA-USB, the underlying network could be WiFi, WiGig, Ethernet etc. The delay can vary depending on the underlying network conditions. A client driver should query the latency periodically or whenever it is notified of a change.

CurrentTotalBandwidthChanged

Contains the total bandwidth of the host controller’s shared transport.

For MA-USB, the underlying network transport could be WiFi, WiGig, Ethernet etc. The total available bandwidth can vary depending on several factors such as the negotiation WiFi channel. A client driver should query the total bandwidth periodically or whenever it is notified of a change.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1709
Minimum supported server Windows Server 2016
Header ucxcontroller.h (include Ucxclass.h)

See also

EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION