Presentation Context

  • Article

banner art

Previous Next

Presentation Context

The presentation context contains name-value pairs that describe the content requested by a client. There is one context for each client. The following table identifies the context values defined by Windows Media Services.

Name Value
(data type)		 Key Description
WMS_PRESENT_BITRATE long 11 Contains the maximum bit rate for the streams sent to the client. This value is constant and is determined by the server at the start of the presentation.
WMS_PRESENT_BROADCAST long 6 Contains a value that specifies whether a presentation is a broadcast. A value of 1 indicates true and 0 indicates false.
WMS_PRESENT_CONTENT_DESCRIPTION IUnknown* 3 Contains an IUnknown pointer that you can use to retrieve a pointer to an IWMSContentDescriptionList interface. You can call the GetAndQueryIUnknownValue method on the IWMSContext interface to retrieve a pointer to IWMSContentDescriptionList.
WMS_PRESENT_DURATION_HI long 12 Contains the high-order 32 bits of a 64-bit integer indicating the maximum possible time, in milliseconds, that the presentation can last. This value is only set if the presentation extends beyond approximately 1200 hours.
WMS_PRESENT_DURATION_LO long 13 Contains the low-order 32 bits of a 64-bit integer indicating the maximum possible time, in milliseconds, that the presentation can last. This value is set for each item in the playlist.
WMS_PRESENT_ORIGINAL_PHYSICAL_NAME String 16 Contains the content location retrieved after the URL requested by the client is resolved to a publishing point. This is the original local source that is retrieved after expanding a publishing point. This is the physical URL before a Physical URL Transform is performed.
WMS_PRESENT_ORIGINAL_REQUEST_NAME String 17 Contains the URL requested by the client.
WMS_PRESENT_PHYSICAL_NAME String 4 Contains the URL for the presentation.
WMS_PRESENT_PLAY_RATE double 14 Contains the rate at which the presentation is streamed. A value of 1 indicates normal forward speed. A value greater that 1 indicates that the content is being fast-forwarded. A value less than 0 indicates that the content is being rewound. For example, a value of 2 indicates that the content is being fast forwarded at twice the normal rate, and -2 indicates that it is being rewound at twice the normal rate. This value is copied from the WMS_COMMAND_CONTEXT_RATE context value.
WMS_PRESENT_PLAYLIST_ENTRY_ROLE String 45 Contains the role attribute in a playlist.
WMS_PRESENT_PREROLL_TIME long 81 Contains the amount of preroll time, in milliseconds, specified in the Windows Media file header for the content. The preroll is initially determined by Windows Media Encoder and represents the amout of content that must exist on the client before the content can be played.
WMS_PRESENT_REDIRECT_LOCATION String 70 Contains a URL sent by the cache manager in response to NS_E_REDIRECT. For more information, see Implementing Reverse Proxy.
WMS_PRESENT_RELIABLE long 8 Contains a flag that indicates whether the digital media stream must be carried over a reliable data communications transport mechanism. The value of the flag is 1 for true and 0 for false.
WMS_PRESENT_REQUEST_NAME String 5 Contains the URL requested by the client.
WMS_PRESENT_SEEKABLE long 7 Contains a flag that indicates whether the end user can seek to a specific time offset in the digital media stream. The value of the flag is 1 for true and 0 for false. Only on-demand content is seekable.
WMS_PRESENT_START_TIME QWORD 15 Contains the start time of the presentation. This is the start time of the play request, in milliseconds, as an offset from the beginning of the stream. This might not be present in all play requests.
WMS_PRESENT_STREAM_HEADERS IUnknown* 2 Contains an IUnknown pointer that you can use to retrieve a pointer to an IWMSStreamHeaderList interface. The IWMSStreamHeaderList interface contains a collection of IWMSStreamHeader objects that describe each item of content in a presentation. You can call the GetAndQueryIUnknownValue method on the IWMSContext interface to retrieve a pointer to IWMSStreamHeaderList.
WMS_PRESENT_TOTAL_BYTES_SENT_HI long 18 Contains the high-order 32 bits of a 64-bit integer containing the total number of bytes that have been sent to the client.
WMS_PRESENT_TOTAL_BYTES_SENT_LO long 19 Contains the low-order 32 bits of a 64-bit integer containing the total number of bytes that have been sent to the client.
WMS_PRESENT_TOTAL_PLAY_TIME_HI long 20 Contains the high-order 32 bits of a 64-bit integer containing the total presentation time, in seconds.
WMS_PRESENT_TOTAL_PLAY_TIME_LO long 21 Contains the low-order 32 bits of a 64-bit integer containing the total presentation time, in seconds.
WMS_PRESENT_WMSSINK_SELECTED_BITRATE DWORD 51 Contains the bit rate of the content that is being sent to the client.

See Also (General)

See Also (Visual Basic .NET)

See Also (C#)

See Also (C++)

Previous Next