WMT_STATUS enumeration (wmsdkidl.h)

[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

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
} ;

Constants

WMT_ERROR Value: 0 An error occurred.
WMT_OPENED Value: 1 A file was opened.
WMT_BUFFERING_START Value: 2 The reader object is beginning to buffer content.
WMT_BUFFERING_STOP Value: 3 The reader object has finished buffering content.
WMT_EOF Value: 4 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 Value: 4 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 Value: 5 The end of a segment has been encountered.
WMT_END_OF_STREAMING Value: 6 The end of a server-side playlist has been reached.
WMT_LOCATING Value: 7 The reader object is locating requested data.
WMT_CONNECTING Value: 8 A reporting object is connecting to server.
WMT_NO_RIGHTS Value: 9 There is no license and the content is protected by version 1 digital rights management.
WMT_MISSING_CODEC Value: 10 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 Value: 11 A reporting object has begun operations.
WMT_STOPPED Value: 12 A reporting object has ceased operations.
WMT_CLOSED Value: 13 A file was closed.
WMT_STRIDING Value: 14 The reader object is playing content at above normal speed, or in reverse.
WMT_TIMER Value: 15 Timer event.
WMT_INDEX_PROGRESS Value: 16 Progress update from the indexer object.
WMT_SAVEAS_START Value: 17 The reader object has begun saving a file from a server.
WMT_SAVEAS_STOP Value: 18 The reader has stopped saving a file from a server.
WMT_NEW_SOURCEFLAGS Value: 19 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 Value: 20 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 Value: 21 A license backup or restore has started.
WMT_SOURCE_SWITCH Value: 22 The next source in the playlist was opened.
WMT_ACQUIRE_LICENSE Value: 23 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 Value: 24 Individualization status message.
WMT_NEEDS_INDIVIDUALIZATION Value: 25 The file loaded in the reader object cannot be played without a security update.
WMT_NO_RIGHTS_EX Value: 26 There is no license and the content is protected by version 7 digital rights management.
WMT_BACKUPRESTORE_END Value: 27 A license backup or restore has finished.
WMT_BACKUPRESTORE_CONNECTING Value: 28 The backup restorer object is connecting to a server.
WMT_BACKUPRESTORE_DISCONNECTING Value: 29 The backup restorer object is disconnecting from a server.
WMT_ERROR_WITHURL Value: 30 Error relating to the URL.
WMT_RESTRICTED_LICENSE Value: 31 The backup restorer object cannot back up one or more licenses because the right has been disallowed by the content owner.
WMT_CLIENT_CONNECT Value: 32 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 Value: 33 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 Value: 34 Change in output properties.
WMT_RECONNECT_START Value: 35 Start of automatic reconnection to a server.
WMT_RECONNECT_END Value: 36 End of automatic reconnection to a server.
WMT_CLIENT_CONNECT_EX Value: 37 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 Value: 38 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 Value: 39 Change to the forward error correction span.
WMT_PREROLL_READY Value: 40 The reader is ready to begin buffering content.
WMT_PREROLL_COMPLETE Value: 41 The reader is finished buffering.
WMT_CLIENT_PROPERTIES Value: 42 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 Value: 43 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 Value: 44 Sent when the IWMReaderPlaylistBurn::InitPlaylistBurn method returns.
WMT_TRANSCRYPTOR_INIT Value: 45 Sent when the DRM transcryptor object is initialized with a file.
WMT_TRANSCRYPTOR_SEEKED Value: 46 Sent when the DRM transcryptor object seeks to a point in a file.
WMT_TRANSCRYPTOR_READ Value: 47 Sent when the DRM transcryptor object delivers Windows Media DRM 10 for Network Devices data from a DRM-protected file.
WMT_TRANSCRYPTOR_CLOSED Value: 48 Sent when the DRM transcryptor object is closed. After receiving this message, you can release the interface.
WMT_PROXIMITY_RESULT Value: 49 Sent when the proximity detection protocol has finished.
WMT_PROXIMITY_COMPLETED Value: 50 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 Value: 51 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

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only],Windows Media Format 7 SDK, or later versions of the SDK
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	wmsdkidl.h (include Wmsdk.h)

See also

Enumeration Types