![](../../Home/Icons/Home.gif)
![](../icons/UpCNM.gif)
![](../icons/CNMContext.gif)
![](../../Home/Icons/Search.gif)
Taxonomy Categories:
Member Functions:
Interface Category:
API.
Inherits From:
TMediaType
Inherited By:
None.
Purpose:
This class represents the media type and component category of media components.
Instantiation:
Allocate on the heap or the stack.
Deriving Classes:
Not intended to be derived.
Concurrency:
Not multithread safe.
Resource Use:
No special requirements.
- TMediaComponentType ()
- TMediaComponentType (const TMediaComponentType &)
- TMediaComponentType (const TToken & mediaTypeName, const TToken & componentTypeName)
Interface Category:
API.
Purpose:
- Default constructor. Defaults to the generic media type returned by GetMedia and the default component category returned by GetComponent.
- Copy constructor.
- Creates a TMediaType, allowing the media type value and component category 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 TMediaType::GetAudio, TMediaType::GetGraphic, or TMediaType::GetMIDI along with GetPlayer, GetConveniencePlayer, GetInputDevice, and GetOutputDevice to create a combination of predefined types, or they can pass in TTokens that they have defined. Called by TMediaComponent and derived classes.
Parameters:
- Takes no parameters.
- const TMediaComponentType & -The media component type you want to copy.
- const TToken & mediaTypeName -The media type token value.
- const TToken & componentTypeName -The component type token value.
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual ~ TMediaComponentType ()
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.
TMediaComponentType & operator =(const TMediaComponentType &)
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: TMediaComponentType::GetMediaComponentType
TToken GetMediaComponentType () const
Interface Category:
API.
Purpose:
Provides access to the data member associated with this class.
Calling Context:
Call directly to determine the component category. Used by TimeMediaRegistryServer and Media UI Framework.
Parameters:
Return Value:
TToken -Contains the value of the component type.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
static const TToken & GetComponent ()
Interface Category:
API.
Purpose:
Defines a default component type value.
Calling Context:
Call directly when creating a TMediaComponentType. Used by TMediaComponent derived classes.
Parameters:
Return Value:
A TToken containing the predefined default component value.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
static const TToken & GetPlayer ()
Interface Category:
API.
Purpose:
Defines a player type value for derived classes of TPlayer.
Calling Context:
Call directly when creating a TMediaComponentType. Used by TPlayer derived classes.
Parameters:
Return Value:
A TToken containing the predefined player value.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TMediaComponentType::GetConveniencePlayer
static const TToken & GetConveniencePlayer ()
Interface Category:
API.
Purpose:
Defines a convenience player type value for TSound, TMIDI, TMovie, and so on.
Calling Context:
Call directly when creating a TMediaComponentType. Used by TSound, TMIDI, TMovie.
Parameters:
Return Value:
A TToken containing the predefined convenience player value.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
static const TToken & GetInputDevice ()
Interface Category:
API.
Purpose:
Defines an input device type value for analog-to-digital converters, and so on.
Calling Context:
Call directly when creating a TMediaComponentType.
Parameters:
Return Value:
A TToken containing the predefined input device value.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
static const TToken & GetOutputDevice ()
Interface Category:
API.
Purpose:
Defines an output device type value for digital-to-analog converters, and so on.
Calling Context:
Call directly when creating a TMediaComponentType.
Parameters:
Return Value:
A TToken containing the predefined output device value.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
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.
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.
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.