RSVP_RESERVE_INFO

[This is preliminary documentation and subject to change.]

The GQOS object RSVP_RESERVE_INFO, through the ProviderSpecific buffer, allows RSVP behavior for a given flow to be specified or modified at a granular level, and allows default RSVP style settings for a flow to be overridden. Although RSVP_RESERVE_INFO is technically a structure, its use within GQOS technology, and especially its required inclusion of the QOS_OBJECT_HDR as its first member, define it as a GQOS object.

typedef struct _RSVP_RESERVE_INFO {
   QOS_OBJECT_HDR    ObjectHdr;         /* type and length of     */
                                        /*   this object          */
   ULONG             Style;             /* RSVP Style (FF,WF,SE)  */
   ULONG             ConfirmRequest;    /* Non Zero for Confirm   */
                                        /*   Request(receive only)*/
   ULONG             NumPolicyElement;  /* Number of policy       */
                                        /*   elements             */
   LPRSVP_POLICY     PolicyElementList; /* Points to the set of   */
                                        /*   policy elements      */
   ULONG             NumFlowDesc;       /* Number of FlowDesc     */
   LPFLOWDESCRIPTOR  FlowDescList;      /* Points to the FlowDesc */
                                        /*   list                 */
} RSVP_RESERVE_INFO, *LPRSVP_RESERVE_INFO;

Members

ObjectHdr

The GQOS object QOS_OBJECT_HDR.

Style

Specifies the RSVP reservation style for a given flow, and can be used to replace default reservation styles placed on a particular type of flow. This member can be one of the following values.

Value	Meaning
RSVP_WILDCARD_SYLE	Implements the WF RSVP reservation style. RSVP_WILDCARD_STYLE is the default value for multicast receivers and UDP unicast receivers. Specifying RSVP_WILDCARD_STYLE through RSVP_RESERVE_INFO is useful for overriding the default value (RSVP_FIXED_FILTER_STYLE) applied to connected unicast receivers.
RSVP_FIXED_FILTER_STYLE	Implements the Fixed Filter (FF) RSVP reservation style. RSVP_FIXED_FILTER_STYLE is useful for overriding the default style for multicast receivers or unconnected UDP unicast receivers (RSVP_WILDCARD_STYLE). RSVP_FIXED_FILTER_STYLE may also be used to generate multiple RSVP_FIXED_FILTER_STLYE reservations in instances where only a single RSVP_FIXED_FILTER_STYLE reservation will be generated by default, such as with connected unicast receivers.
RSVP_SHARED_EXPLICIT_STYLE	Implements the Shared Explicit (SE) RSVP reservation style.

ConfirmRequest

Can be used by a receiving application to request notification of its reservation request by setting ConfirmRequest to a nonzero value. Such notification is achieved when RSVP-aware devices in the data path between sender and receiver (or vice-versa) transmit a RESV CONFIRMATION message toward the requesting node. Note that an RSVP node is not required to automatically generate RESV CONFIRMATION messages.

NumPolicyElement

Specifies the number of policy elements.

PolicyElementList

Pointer to the set of policy elements. Optional policy information, as provided in an RSVP_POLICY structure.

NumFlowDesc

Specifies the FLOWDESCRIPTOR count.

FlowDescList

Pointer to the list of FLOWDESCRIPTORs.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in traffic.h.