Microsoft DirectX 8.0 |
Represents a tuning space with a network type of Analog TV.
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).
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 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 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 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 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 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 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 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.