![](../../Home/Icons/Home.gif)
![](../icons/UpCNM.gif)
![](../icons/CNMContext.gif)
![](../../Home/Icons/Search.gif)
Taxonomy Categories:
Member Functions:
Interface Category:
API.
Inherits From:
MCollectible
Inherited By:
TAudioType
TGraphicType
TMIDIType
TMediaComponentType
TMovieType
Purpose:
The base class for representing the type of media handled by time-based media sequences and components.
Instantiation:
Allocate on the heap or the stack.
Deriving Classes:
TMediaType is derived to provide type information for particular media components or media data formats, for example TMediaComponentType, TAudioType, TGraphicType, TMIDIType. Because this class has no virtual member functions, derived classes add new members rather than overriding the existing ones.
Concurrency:
Not multithread safe.
Resource Use:
No special requirements.
- TMediaType ()
- TMediaType (const TMediaType &)
- TMediaType (const TToken & mediaTypeName)
Interface Category:
API.
Purpose:
- Default constructor. Defaults to the generic media type returned by GetMedia.
- Copy constructor.
- Creates a TMediaType, allowing the media type value to be specified.
Calling Context:
- Call directly to create a default object that will immediately be assigned to or streamed into. Used by TimeMediaRegistryServer.
- Call directly to copy an object. Used by TimeMediaRegistryServer.
- Call directly to create a fully specified audio type. Callers can use GetAudio, GetGraphic, or GetMIDI to create a predefined type, or they can pass in a TToken that they have defined. Called by TMediaComponent and derived classes.
Parameters:
- Takes no parameters.
- const TMediaType & -The media type you want to copy.
- const TToken & mediaTypeName -The media type token value.
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual ~ TMediaType ()
Interface Category:
API.
Purpose:
Destructor.
Calling Context:
Call directly to destroy an object. Used by TimeMediaRegistryServer.
Parameters:
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TMediaType::operator=
TMediaType & operator =(const TMediaType &)
Interface Category:
API.
Purpose:
Assignment operator.
Calling Context:
Call directly when an object is assigned to another compatible object. Used by TimeMediaRegistryServer.
Parameters:
- const TMediaType & -The source object for the assignment.
Return Value:
A non-const reference to the left-hand side object.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TMediaType::GetMediaType
TToken GetMediaType () const
Interface Category:
API.
Purpose:
Provides access to the data member associated with this class.
Calling Context:
Call directly to determine the value of this type. Used by TimeMediaRegistryServer and Media UI Framework.
Parameters:
Return Value:
TToken -Contains the value of this type.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None
Member Function: TMediaType::GetMedia
static const TToken & GetMedia ()
Interface Category:
API.
Purpose:
Defines a default media type value.
Calling Context:
Call directly when creating a TMediaType. Called by TMediaComponent and derived classes.
Parameters:
Return Value:
A TToken containing the predefined default media value.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TMediaType::GetAudio
static const TToken & GetAudio ()
Interface Category:
API.
Purpose:
Defines an audio type value.
Calling Context:
Call directly when creating a TMediaType. Called by TAudioType and by TSound.
Parameters:
Return Value:
A TToken containing the predefined audio value.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TMediaType::GetGraphic
static const TToken & GetGraphic ()
Interface Category:
API.
Purpose:
Defines a graphic type value for the graphic portion of the movie data.
Calling Context:
Call directly when creating a TMediaType. Called by TGraphicType.
Parameters:
Return Value:
A TToken containing the predefined graphic value.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TMediaType::GetMIDI
static const TToken & GetMIDI ()
Interface Category:
API.
Purpose:
Defines a MIDI type value.
Calling Context:
Call directly when creating a TMediaType. Called by TMIDIType and by TMIDI.
Parameters:
Return Value:
A TToken containing the predefined MIDI value.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TMediaType::GetMovie
static const TToken & GetMovie ()
Interface Category:
API.
Purpose:
Defines a movie type value.
Calling Context:
Call directly when creating a TMediaType. Called by TMovieType and by TMovie.
Parameters:
Return Value:
A TToken containing the predefined default movie value.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TMediaType::operator<<=
virtual TStream & operator <<= (TStream & fromWhere)
Interface Category:
API.
Purpose:
Stream-in operator.
Calling Context:
Call directly to stream in data. Used by TimeMediaRegistryServer.
Parameters:
- TStream & fromWhere -The stream the object streams itself in from.
Return Value:
Returns a reference to the stream the object streams itself in from.
Exceptions:
Throws TInvalidVersionError if the versions don't match.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TMediaType::operator>>=
virtual TStream & operator >>=(TStream & toWhere) const
Interface Category:
API.
Purpose:
Stream-out operator.
Calling Context:
Call directly to stream out data. Used by TimeMediaRegistryServer.
Parameters:
- TStream & toWhere -The stream the object streams itself out to.
Return Value:
Returns a reference to the stream the object streams itself out to.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TMediaType::Hash
virtual long Hash () const
Interface Category:
API.
Purpose:
Generates a hash value.
Calling Context:
Called by collection classes.
Parameters:
Return Value:
Returns the hash value.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Click the icon to mail questions or corrections about this material to Taligent personnel.
Copyright©1995 Taligent,Inc. All rights reserved.