Share via


CMediaControl Class

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Aa927720.89a7e270-030a-42d5-8f9e-dbaddab07a3d(en-us,MSDN.10).gif

This class provides base class handling of the IDispatch methods of the dual-interface IMediaControl. It leaves as pure virtual the properties and methods of the IMediaControl interface.

Typically, the filter graph manager is the only object that implements the IMediaControl interface. (Filters implement the IMediaFilter interface, inherited by IBaseFilter, to receive control commands from the filter graph manager.) Therefore, this class library is of limited use to filter developers.

The CMediaControl::GetIDsOfNames, CMediaControl::GetTypeInfo, CMediaControl::GetTypeInfoCount, and CMediaControl::Invoke member functions are standard implementations of the IDispatch methods using the CBaseDispatch class (and a type library) to parse the commands and pass them to the pure virtual methods of the IMediaControl interface.

The IMediaControl methods, defined in Control.odl, are left as pure virtual.

Member Functions

Member function Description

CMediaControl

Constructs a CMediaControl object.

Implemented INonDelegatingUnknown Methods

Method Description

NonDelegatingQueryInterface

Returns a specified reference-counted interface.

Implemented IDispatch Methods

Method Description

GetIDsOfNames

Maps a single member and an optional set of parameters to a corresponding set of integer dispatch identifiers (DISPIDs), which can be used during subsequent calls to the CMediaControl::Invoke method.

GetTypeInfo

Retrieves a type-information object, which can retrieve the type information for an interface.

GetTypeInfoCount

Retrieves the number of type-information interfaces provided by an object.

Invoke

Provides access to properties and methods exposed by an object.

Requirements

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment