WMT_STATUS enumeration

The WMT_STATUS enumeration type defines a range of file status information. Members of WMT_STATUS are passed to the common callback function, IWMStatusCallback::OnStatus, so that the application can respond to the changing status of the objects being used.

Syntax


typedef enum WMT_STATUS { 
  WMT_ERROR                        = 0,
  WMT_OPENED                       = 1,
  WMT_BUFFERING_START              = 2,
  WMT_BUFFERING_STOP               = 3,
  WMT_EOF                          = 4,
  WMT_END_OF_FILE                  = 4,
  WMT_END_OF_SEGMENT               = 5,
  WMT_END_OF_STREAMING             = 6,
  WMT_LOCATING                     = 7,
  WMT_CONNECTING                   = 8,
  WMT_NO_RIGHTS                    = 9,
  WMT_MISSING_CODEC                = 10,
  WMT_STARTED                      = 11,
  WMT_STOPPED                      = 12,
  WMT_CLOSED                       = 13,
  WMT_STRIDING                     = 14,
  WMT_TIMER                        = 15,
  WMT_INDEX_PROGRESS               = 16,
  WMT_SAVEAS_START                 = 17,
  WMT_SAVEAS_STOP                  = 18,
  WMT_NEW_SOURCEFLAGS              = 19,
  WMT_NEW_METADATA                 = 20,
  WMT_BACKUPRESTORE_BEGIN          = 21,
  WMT_SOURCE_SWITCH                = 22,
  WMT_ACQUIRE_LICENSE              = 23,
  WMT_INDIVIDUALIZE                = 24,
  WMT_NEEDS_INDIVIDUALIZATION      = 25,
  WMT_NO_RIGHTS_EX                 = 26,
  WMT_BACKUPRESTORE_END            = 27,
  WMT_BACKUPRESTORE_CONNECTING     = 28,
  WMT_BACKUPRESTORE_DISCONNECTING  = 29,
  WMT_ERROR_WITHURL                = 30,
  WMT_RESTRICTED_LICENSE           = 31,
  WMT_CLIENT_CONNECT               = 32,
  WMT_CLIENT_DISCONNECT            = 33,
  WMT_NATIVE_OUTPUT_PROPS_CHANGED  = 34,
  WMT_RECONNECT_START              = 35,
  WMT_RECONNECT_END                = 36,
  WMT_CLIENT_CONNECT_EX            = 37,
  WMT_CLIENT_DISCONNECT_EX         = 38,
  WMT_SET_FEC_SPAN                 = 39,
  WMT_PREROLL_READY                = 40,
  WMT_PREROLL_COMPLETE             = 41,
  WMT_CLIENT_PROPERTIES            = 42,
  WMT_LICENSEURL_SIGNATURE_STATE   = 43,
  WMT_INIT_PLAYLIST_BURN           = 44,
  WMT_TRANSCRYPTOR_INIT            = 45,
  WMT_TRANSCRYPTOR_SEEKED          = 46,
  WMT_TRANSCRYPTOR_READ            = 47,
  WMT_TRANSCRYPTOR_CLOSED          = 48,
  WMT_PROXIMITY_RESULT             = 49,
  WMT_PROXIMITY_COMPLETED          = 50,
  WMT_CONTENT_ENABLER              = 51
} WMT_STATUS;

Constants

WMT_ERROR

An error occurred.

WMT_OPENED

A file was opened.

WMT_BUFFERING_START

The reader object is beginning to buffer content.

WMT_BUFFERING_STOP

The reader object has finished buffering content.

WMT_EOF

The end of the file has been reached. Both this member and the next one, WMT_END_OF_FILE, have the value 4.

WMT_END_OF_FILE

The end of the file has been reached. Both this member and the previous one, WMT_EOF, have the value 4.

WMT_END_OF_SEGMENT

The end of a segment has been encountered.

WMT_END_OF_STREAMING

The end of a server-side playlist has been reached.

WMT_LOCATING

The reader object is locating requested data.

WMT_CONNECTING

A reporting object is connecting to server.

WMT_NO_RIGHTS

There is no license and the content is protected by version 1 digital rights management.

WMT_MISSING_CODEC

The file loaded in the reader object contains compressed data for which no codec could be found. The pValue parameter in OnStatus contains a GUID. The first DWORD of this GUID contains the FOURCC or the format tag of the missing codec. The remaining bytes of the GUID can be ignored.

The hr parameter in OnStatus may equal S_OK, although a missing codec would normally be considered an error. Also, this event may be followed by WMT_STARTED with hr equal to S_OK, even if codecs are missing for every stream in the file. In that case, however, the application will not receive any decoded samples, and should stop the reader object.

WMT_STARTED

A reporting object has begun operations.

WMT_STOPPED

A reporting object has ceased operations.

WMT_CLOSED

A file was closed.

WMT_STRIDING

The reader object is playing content at above normal speed, or in reverse.

WMT_TIMER

Timer event.

WMT_INDEX_PROGRESS

Progress update from the indexer object.

WMT_SAVEAS_START

The reader object has begun saving a file from a server.

WMT_SAVEAS_STOP

The reader has stopped saving a file from a server.

WMT_NEW_SOURCEFLAGS

The current file's header object contains certain attributes that are different from those of the previous file. This event is sent when playing a server-side playlist. Use the IWMHeaderInfo interface to query for any of the following attributes in a new file: Stridable, Broadcast, Seekable, and HasImage.

WMT_NEW_METADATA

The current file's header object contains metadata attributes that are different from those of the previous file. This event is sent when playing a server-side playlist. Use the IWMHeaderInfo interface to query for any metadata attribute you are interested in.

WMT_BACKUPRESTORE_BEGIN

A license backup or restore has started.

WMT_SOURCE_SWITCH

The next source in the playlist was opened.

WMT_ACQUIRE_LICENSE

The license acquisition process has completed. The pValue parameter in OnStatus contains a WM_GET_LICENSE_DATA structure. The hr member of this structure indicates whether the license was successfully acquired.

WMT_INDIVIDUALIZE

Individualization status message.

WMT_NEEDS_INDIVIDUALIZATION

The file loaded in the reader object cannot be played without a security update.

WMT_NO_RIGHTS_EX

There is no license and the content is protected by version 7 digital rights management.

WMT_BACKUPRESTORE_END

A license backup or restore has finished.

WMT_BACKUPRESTORE_CONNECTING

The backup restorer object is connecting to a server.

WMT_BACKUPRESTORE_DISCONNECTING

The backup restorer object is disconnecting from a server.

WMT_ERROR_WITHURL

Error relating to the URL.

WMT_RESTRICTED_LICENSE

The backup restorer object cannot back up one or more licenses because the right has been disallowed by the content owner.

WMT_CLIENT_CONNECT

Sent when a client (a playing application or server) connects to a writer network sink object. The pValue parameter of the IWMStatusCallback::OnStatus callback is set to a WM_CLIENT_PROPERTIES structure. New applications should wait for WMT_CLIENT_CONNECT_EX instead.

WMT_CLIENT_DISCONNECT

Sent when a client (a playing application or server) disconnects from a writer network sink object. The pValue parameter of the IWMStatusCallback::OnStatus callback is set to a WM_CLIENT_PROPERTIES structure. The values in this structure are identical to those sent on connection. New applications should wait for WMT_CLIENT_DISCONNECT_EX instead.

WMT_NATIVE_OUTPUT_PROPS_CHANGED

Change in output properties.

WMT_RECONNECT_START

Start of automatic reconnection to a server.

WMT_RECONNECT_END

End of automatic reconnection to a server.

WMT_CLIENT_CONNECT_EX

Sent when a client (a playing application or server) connects to a writer network sink object. The pValue parameter of the IWMStatusCallback::OnStatus callback is set to a WM_CLIENT_PROPERTIES_EX structure.

WMT_CLIENT_DISCONNECT_EX

Sent when a client (a playing application or server) disconnects from a writer network sink object. The pValue parameter of the IWMStatusCallback::OnStatus callback is set to a WM_CLIENT_PROPERTIES_EX structure. The client properties are identical to those sent on connection except for the pwszDNSName member, which may have changed.

WMT_SET_FEC_SPAN

Change to the forward error correction span.

WMT_PREROLL_READY

The reader is ready to begin buffering content.

WMT_PREROLL_COMPLETE

The reader is finished buffering.

WMT_CLIENT_PROPERTIES

Sent by a writer network sink when one or more properties of a connected client changes. The pValue parameter of the IWMStatusCallback::OnStatus callback is set to a WM_CLIENT_PROPERTIES_EX structure. This usually means that a DNS name is present for a client for which none was available at connection.

WMT_LICENSEURL_SIGNATURE_STATE

Sent before a WMT_NO_RIGHTS or WMT_NO_RIGHTS_EX status message. The pValue parameter is set to one of the WMT_DRMLA_TRUST constants indicating whether the license acquisition URL is completely trusted.

WMT_INIT_PLAYLIST_BURN

Sent when the IWMReaderPlaylistBurn::InitPlaylistBurn method returns.

WMT_TRANSCRYPTOR_INIT

Sent when the DRM transcryptor object is initialized with a file.

WMT_TRANSCRYPTOR_SEEKED

Sent when the DRM transcryptor object seeks to a point in a file.

WMT_TRANSCRYPTOR_READ

Sent when the DRM transcryptor object delivers Windows Media DRM 10 for Network Devices data from a DRM-protected file.

WMT_TRANSCRYPTOR_CLOSED

Sent when the DRM transcryptor object is closed. After receiving this message, you can release the interface.

WMT_PROXIMITY_RESULT

Sent when the proximity detection protocol has finished.

WMT_PROXIMITY_COMPLETED

Sent when proximity detection thread has stopped running. The application must not release the IWMProximityDetection interface until this message is received. Once launched, the thread runs for two minutes; there is no way to terminate the thread before two minutes have elapsed.

WMT_CONTENT_ENABLER

Sent when a content enabler is required.

Remarks

For more information on how this enumeration type is used, see the Remarks section for the IWMStatusCallback::OnStatus method.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Version

Windows Media Format 7 SDK, or later versions of the SDK

Header

Wmsdkidl.h (include Wmsdk.h)

See also

Enumeration Types

 

 

Show: