GUID attribute
Traffic control uses GUIDs to convey information about the status of packet shaper interfaces, to report errors, and to provide statistics.
The GUID_QOS_STATISTICS_BUFFER structure is actually an array of PS_COMPONENT_STATS structures, which in turn serve as a container structure, holding one of the five following structures in its Stats member:
The following table lists GUIDs used with packet shaper on QOS-enabled computers. In the scope column, P/I indicates that the GUID is based per-interface, and P/F indicates it is based per-flow.
| GUID | Size | Scope | Settable? | Notification? | Description |
|---|---|---|---|---|---|
| GUID_QOS_REMAINING_BANDWIDTH | ULONG | P/I | No | Yes | The remaining amount of reservable bandwidth on this interface. |
| GUID_QOS_BESTEFFORT_BANDWIDTH | ULONG | P/I | No | No | The remaining amount of bandwidth. |
| GUID_QOS_LATENCY | ULONG | P/I | No | No | The latency of this interface. |
| GUID_QOS_FLOW_COUNT | ULONG | P/I | No | Yes | Number of active flows. |
| GUID_QOS_NON_BESTEFFORT_LIMIT | ULONG | P/I | No | No | The total amount of reservable bandwidth. |
| GUID_QOS_MAX_OUTSTANDING_SENDS | ULONG | P/I | No | No | Maximum number of sends that can be outstanding on this interface. |
| GUID_QOS_STATISTICS_BUFFER | See the following. | P/I, P/F | Yes | No | Statistics collected for flow or interface. The GUID_QOS_STATISTICS_BUFFER structure is actually an array of PS_COMPONENT_STATS structures, as described in the preceding. |
| GUID_QOS_FLOW_MODE | ULONG | P/I | Yes | No | Mode of operation for the interface: ADAPTER_FLOW_MODE_STANDARD or ADAPTER_FLOW_MODE_DIFFSERV. Note that you must specify the constants rather than Standard or Diffserv when using this GUID. These constants are defined in ntddpsch.h |
| GUID_QOS_ISSLOW_FLOW | ULONG | P/F | No | No | Indicates an ISSLOW flow. |
| GUID_QOS_TIMER_RESOLUTION | ULONG | none | No | No | Timer resolution, in microseconds. |
| GUID_QOS_FLOW_IP_CONFORMING | ULONG | P/F | No | No | The conforming DSCP value for this flow. |
| GUID_QOS_FLOW_IP_NONCONFORMING | ULONG | P/F | No | No | The nonconforming SCP value for this flow. |
| GUID_QOS_FLOW_8021P_CONFORMING | ULONG | P/F | No | No | The conforming 802.1p value for this flow |
| GUID_QOS_FLOW_8021P_NONCONFORMING | ULONG | P/F | No | No | The nonconforming 802.1p value for this flow. |
| GUID_QOS_ENABLE_AVG_STATS | ULONG | P/I, P/F | Yes | No | Enables averaging statistics in the Packet Scheduler (provides the average number of packets in the shaper). |
| GUID_QOS_ENABLE_WINDOW_ADJUSTMENT | ULONG | P/I | Yes | No | Enables TCP window size adjustment for TCP connections on a slow ling, running ICS. |
Remarks
In the GUID_QOS_STATISTICS_BUFFER GUID described in the table above, you must pass in a buffer that is large enough to hold all returned PS_COMPONENT_STATS structures.
See also