ITuningSpace Interface

  • Article

The ITuningSpace interface provides the common functionality for all network-specific tuning spaces. Applications can obtain tuning spaces from the SystemTuningSpaces collection. A tuning space generally exposes an interface that inherits ITuningSpace, such as IATSCTuningSpace.

Methods

The ITuningSpace interface inherits the methods of the IDispatch interface.

In addition, ITuningSpace defines the following methods.

Method Description

Clone

Creates a new copy of the tuning space.

CreateTuneRequest

Creates a COM object representing an empty (uninitialized) tune request.

EnumCategoryGUIDs

(Currently not implemented.) Creates an enumerator for the DirectShow category GUIDs, representing classes of filters that support the tuning space.

EnumDeviceMonikers

(Currently not implemented.) Creates an enumerator of device monikers representing the tuner inputs (filters) supporting this tuning space.

get__NetworkType

Retrieves the network type of the tuning space as a GUID.

get_CLSID

Gets the CLSID of the tuning space as a BSTR.

get_DefaultLocator

Retrieves the default locator for a tuning space.

get_DefaultPreferredComponentTypes

Returns an enumeration of the preferred component types, which specify parameters such as the preferred audio stream.

get_FrequencyMapping

Retrieves the frequency mapping previously created by the network provider.

get_FriendlyName

Retrieves the localized, user-friendly name of the tuning space.

get_NetworkType

Retrieves the network type of the tuning space as a BSTR.

get_UniqueName

Retrieves a unique name for the tuning space. Can be either a short name, or a GUID.

put__NetworkType

Sets the network type for this tuning space as a CLSID.

put_DefaultLocator

Sets the default locator for a tuning space.

put_DefaultPreferredComponentTypes

Creates an enumeration of the preferred component types, which specify parameters such as the preferred audio stream.

put_FrequencyMapping

Creates a frequency/channel map, frequency/transponder map, or whatever other mapping from carrier frequencies to frequency identifiers is appropriate for the tuning space.

put_FriendlyName

Sets the localized, user-friendly name of the tuning space.

put_NetworkType

Sets the network type for this tuning space as a BSTR.

put_UniqueName

Sets a unique name for the tuning space. Can be either a short name, or a GUID.

See Also

Tuning Model Interfaces

Send comments about this topic to Microsoft

Build date: 12/4/2008