Microsoft DirectX 8.0 |
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.
MethodName Description ITuningSpace Methods get_UniqueName Retrieves a unique name for the Tuning Space. Can be either a short name, or a GUID. put_UniqueName Sets a unique name for the Tuning Space. Can be either a short name, or a GUID. get_FriendlyName Retrieves the localized, user-friendly name of the Tuning Space. put_FriendlyName Sets the localized, user-friendly name of the Tuning Space. get_CLSID Gets the CLSID of the tuning space as a BSTR. get_NetworkType Retrieves the network type GUID of the tuning space as a BSTR. put_NetworkType Sets the network type for this tuning space as a BSTR. get__NetworkType Retrieves the network type of the tuning space as a GUID. put__NetworkType Sets the network type for this tuning space as a REFCLSID. CreateTuneRequest Creates a COM object representing an empty (uninitialized) Tune Request. EnumCategoryGUIDs Creates an enumerator for the DirectShow category GUIDs, representing classes of filters that support the tuning space. EnumDeviceMonikers Creates an enumerator of device monikers representing the tuner inputs (filters) supporting this tuning space. get_DefaultPreferredComponentTypes Returns an enumeration of the preferred component types, which specify parameters such as the preferred audio stream. put_DefaultPreferredComponentTypes Sets an enumeration of the preferred component types, which specify parameters such as the preferred audio stream. get_DefaultLocator Retrieves the default Locator on the local system. put_DefaultLocator Sets the default Locator on the local system. IAnalogTVTuningSpace Methods get_MinChannel Gets the lowest channel number for this tuning space. put_MinChannel Sets the lowest channel number for this tuning space. get_MaxChannel Gets the highest channel number for this tuning space. put_MaxChannel Sets the highest channel number for this tuning space. get_InputType Gets the input type (antenna or cable) intended for the tuning space. put_InputType Sets the input type (antenna or cable) intended for the tuning space. get_CountryCode Gets the country code of the tuning space (based on TAPI country codes). put_CountryCode Sets the country code of the tuning space (based on TAPI country codes). IATSCTuningSpace Methods get_MinMinorChannel Gets the lowest minor channel number ever allowed for this tuning space. put_MinMinorChannel Sets the lowest minor channel number ever allowed for this tuning space. get_MaxMinorChannel Gets the highest minor channel number for this tuning space. put_MaxMinorChannel Sets the highest minor channel number for this tuning space. get_MinPhysicalChannel Gets the lowest physical channel number ever allowed for this tuning space. put_MinPhysicalChannel Sets the lowest physical channel number ever allowed for this tuning space. get_MaxPhysicalChannel Gets the highest physical channel number ever allowed for this tuning space. put_MaxPhysicalChannel Sets the highest physical channel number ever allowed for this tuning space.
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.
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).
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.
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).
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.
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.
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.
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.