Microsoft DirectX 8.0

IATSCTuningSpace Interface

The IATSCTuningSpace inherits from ITuningSpace and IAnalogTVTuningSpace. IATSCTuningSpace is implemented on objects that represent an ATSC network type. These objects are created by the Tuning Space Container based on information in the Registry. An IATSCTuningSpace object creates tune requests that expose IATSCChannelTuneRequest.

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).
IATSCTuningSpace Methods 
get_MinMinorChannelGets the lowest minor channel number ever allowed for this tuning space.
put_MinMinorChannelSets the lowest minor channel number ever allowed for this tuning space.
get_MaxMinorChannelGets the highest minor channel number for this tuning space.
put_MaxMinorChannelSets the highest minor channel number for this tuning space.
get_MinPhysicalChannelGets the lowest physical channel number ever allowed for this tuning space.
put_MinPhysicalChannelSets the lowest physical channel number ever allowed for this tuning space.
get_MaxPhysicalChannelGets the highest physical channel number ever allowed for this tuning space.
put_MaxPhysicalChannelSets the highest physical channel number ever allowed for this tuning space.

IATSCTuningSpace::get_MinMinorChannel

IATSCTuningSpace Interface

Gets the lowest minor channel number ever allowed for this tuning space.

Syntax

HRESULT get_MinMinorChannel(
    short* MinMinorChannelVal
    );

Parameters

MinMinorChannelVal
[out, retval] Pointer to a variable of type short that receives the lowest minor channel.

Return Value

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

IATSCTuningSpace::put_MinMinorChannel

IATSCTuningSpace Interface

Sets the lowest minor channel number ever allowed for this tuning space.

Syntax

HRESULT put_MinMinorChannel(
    short NewMinMinorChannelVal
    );

Parameters

NewMinMinorChannelVal
[in] Variable of type short that specifies the lowest minor channel.

Return Value

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

Remarks

This property must be set after setting the MaxMinorChannel property to avoid the case where the minimum minor channel is greater than the maximum minor channel. Both properties default to -1 (not set).

IATSCTuningSpace::get_MaxMinorChannel

IATSCTuningSpace Interface

Gets the highest minor channel number for this tuning space.

Syntax

HRESULT get_MaxMinorChannel(
    short* MaxMinorChannelVal
    );

Parameters

MaxMinorChannelVal
[out, retval] Pointer to a variable of type short that receives the highest minor channel.

Return Value

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

IATSCTuningSpace::put_MaxMinorChannel

IATSCTuningSpace Interface

Gets the highest minor channel number for this tuning space.

Syntax

HRESULT put_MaxMinorChannel(
    short NewMaxMinorChannelVal
    );

Parameters

NewMaxMinorChannelVal
[in] Variable of type short that specifies the highest minor channel.

Return Value

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

Remarks

This property must be set before setting the MinMinorChannel property to avoid the case where the minimum minor channel is greater than the maximum minor channel. Both properties default to -1 (not set).

IATSCTuningSpace::get_MinPhysicalChannel

IATSCTuningSpace Interface

Sets the lowest physical channel number for this tuning space.

Syntax

HRESULT get_MinPhysicalChannel(
    short* MinPhysicalChannelVal
    );

Parameters

MinPhysicalChannelVal
[out, retval] Pointer to a variable of type short that receives the lowest physical channel.

Return Value

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

IATSCTuningSpace::put_MinPhysicalChannel

IATSCTuningSpace Interface

Sets the lowest physical channel number for this tuning space.

Syntax

HRESULT put_MinPhysicalChannel(
    short NewMinPhysicalChannelVal
    );

Parameters

NewMinPhysicalChannelVal
[in] Variable of type short that specifies the lowest physical channel.

Return Value

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

IATSCTuningSpace::get_MaxPhysicalChannel

IATSCTuningSpace Interface

Gets the highest physical channel number for this tuning space.

Syntax

HRESULT get_MaxPhysicalChannel(
    short* MaxPhysicalChannelVal
    );

Parameters

MaxPhysicalChannelVal
[out, retval] Pointer to a variable of type short that receives the highest physical channel.

Return Value

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

IATSCTuningSpace::put_MaxPhysicalChannel

IATSCTuningSpace Interface

Sets the highest physical channel number for this tuning space.

Syntax

HRESULT put_MaxPhysicalChannel(
    short NewMaxPhysicalChannelVal
    );

Parameters

NewMaxPhysicalChannelVal
[in] Variable of type short that specifies the highest physical channel.

Return Value

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