Microsoft DirectX 8.0

IAnalogTVTuningSpace Interface

Represents a tuning space with a network type of Analog TV.

MethodNameDescription
ITuningSpace Methods 
get_UniqueNameRetrieves a unique name for the Tuning Space. Can be either a short name, or a GUID.
put_UniqueNameSets a unique name for the Tuning Space. Can be either a short name, or a GUID.
get_FriendlyNameRetrieves the localized, user-friendly name of the Tuning Space.
put_FriendlyNameSets the localized, user-friendly name of the Tuning Space.
get_CLSIDGets the CLSID of the tuning space as a BSTR.
get_NetworkTypeRetrieves the network type GUID of the tuning space as a BSTR.
put_NetworkTypeSets the network type for this tuning space as a BSTR.
get__NetworkTypeRetrieves the network type of the tuning space as a GUID.
put__NetworkTypeSets the network type for this tuning space as a REFCLSID.
CreateTuneRequestCreates a COM object representing an empty (uninitialized) Tune Request.
EnumCategoryGUIDsCreates an enumerator for the DirectShow category GUIDs, representing classes of filters that support the tuning space.
EnumDeviceMonikersCreates an enumerator of device monikers representing the tuner inputs (filters) supporting this tuning space.
get_DefaultPreferredComponentTypesReturns an enumeration of the preferred component types, which specify parameters such as the preferred audio stream.
put_DefaultPreferredComponentTypesSets an enumeration of the preferred component types, which specify parameters such as the preferred audio stream.
get_DefaultLocatorRetrieves the default Locator on the local system.
put_DefaultLocatorSets the default Locator on the local system.
IAnalogTVTuningSpace Methods 
get_MinChannelGets the lowest channel number for this tuning space.
put_MinChannelSets the lowest channel number for this tuning space.
get_MaxChannelGets the highest channel number for this tuning space.
put_MaxChannelSets the highest channel number for this tuning space.
get_InputTypeGets the input type (antenna or cable) intended for the tuning space.
put_InputTypeSets the input type (antenna or cable) intended for the tuning space.
get_CountryCodeGets the country code of the tuning space (based on TAPI country codes).
put_CountryCodeSets the country code of the tuning space (based on TAPI country codes).

IAnalogTVTuningSpace::get_MinChannel

IAnalogTVTuningSpace Interface

Gets the lowest channel number for this tuning space.

Syntax

HRESULT get_MinChannel(
    short* MinChannelVal
    );

Parameters

MinChannelVal
[out, retval] Pointer to a variable of type short that receives the value for the lowest channel.

Return Value

Returns S_OK if successful. If the method fails, error information can be retrieved using the standard COM IErrorInfo interface.

Remarks

An NTSC tuning space connected to an antenna will return a value of 2.

IAnalogTVTuningSpace::put_MinChannel

IAnalogTVTuningSpace Interface

Sets the lowest channel number for this tuning space.

Syntax

HRESULT put_MinChannel(
    short NewMinChannelVal
    );

Parameters

NewMinChannelVal
[in] Variable of type short that specifies the lowest channel number.

Return Value

Returns S_OK if successful. If the method fails, error information can be retrieved using the standard COM IErrorInfo interface.

IAnalogTVTuningSpace::get_MaxChannel

IAnalogTVTuningSpace Interface

Gets the highest channel number for this tuning space.

Syntax

HRESULT get_MaxChannel(
    short* MaxChannelVal
    );

Parameters

MaxChannelVal
[out, retval] Pointer to a variable of type short that receives the value for the highest channel.

Return Value

Returns S_OK if successful. If the method fails, error information can be retrieved using the standard COM IErrorInfo interface.

Remarks

For example, an NTSC tuning space connected to an antenna would return 69.

IAnalogTVTuningSpace::put_MaxChannel

IAnalogTVTuningSpace Interface

Sets the highest channel number for this tuning space.

Syntax

HRESULT put_MaxChannel(
    short NewMaxChannelVal
    );

Parameters

NewMaxChannelVal
[in] Variable of type short that specifies the highest channel number.

Return Value

Returns S_OK if successful. If the method fails, error information can be retrieved using the standard COM IErrorInfo interface.

IAnalogTVTuningSpace::get_InputType

IAnalogTVTuningSpace Interface

Gets the input type (antenna or cable) intended for the tuning space.

Syntax

HRESULT get_InputType(
    TunerInputType* InputTypeVal
    );

Parameters

InputTypeVal
[out, retval] Pointer to a variable of type TunerInputType that receives the input type.

Return Value

Returns S_OK if successful. If the method fails, error information can be retrieved using the standard COM IErrorInfo interface.

IAnalogTVTuningSpace::put_InputType

IAnalogTVTuningSpace Interface

Sets the input type (antenna or cable) intended for the tuning space.

Syntax

HRESULT put_InputType(
    TunerInputType NewInputTypeVal
    );

Parameters

NewInputTypeVal
[in] Variable of type TunerInputType that specifies the input type.

Return Value

Returns S_OK if successful. If the method fails, error information can be retrieved using the standard COM IErrorInfo interface.

IAnalogTVTuningSpace::get_CountryCode

IAnalogTVTuningSpace Interface

Gets the country code of the tuning space (based on TAPI country codes).

Syntax

HRESULT get_CountryCode(
    long* CountryCodeVal
    );

Parameters

CountryCodeVal
[out, retval] Pointer to a variable of type long that receives the value for the country code.

Return Value

Returns S_OK if successful. If the method fails, error information can be retrieved using the standard COM IErrorInfo interface.

Remarks

The tuner can use the country code to locate a likely channel for frequency mapping.

IAnalogTVTuningSpace::put_CountryCode

IAnalogTVTuningSpace Interface

Sets the country code of the tuning space (based on TAPI country codes).

Syntax

HRESULT put_CountryCode(
    long NewCountryCodeVal
    );

Parameters

NewCountryCodeVal
[in] Variable of type long that specifies the country code.

Return Value

Returns S_OK if successful. If the method fails, error information can be retrieved using the standard COM IErrorInfo interface.

Remarks

The tuner can use the country code to locate a likely channel for frequency mapping.