Platform SDK: Quality of Service

GUID

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 Windows 2000 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_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 this interface: STANDARD or DIFFSERV. Note that you must specify the constants rather than Standard or Diffserv when using this GUID.
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.

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.

Requirements

  Version: Requires MAPI 1.0 or later.
  Header: Declared in Mapiguid.h.