IMVSCTVTuner

The IMVSCTVTuner interface contains methods and properties to configure a TV tuner device.

Methods:

Typelib: MV SmartControl

Analog Video Standard Table

TV Tuner Modes

TV Tuner Input Type

Method IMVSCTVTuner::ChannelMinMax

Declaration: Sub ChannelMinMax(SourceFilter As String, ChannelMin As Long, ChannelMax As Long)

The ChannelMinMax method retrieves the highest and lowest channels available.

Parameter:

	SourceFilter	Name of the source filter.
	ChannelMin	Receives the lowest channel.
	ChannelMax	Receives the highest channel.

C Prototype:

HRESULT ChannelMinMax(BSTR SourceFilter, LONG* ChannelMin, LONG* ChannelMax);

Method IMVSCTVTuner::GetAudioFrequency

Declaration: Function GetAudioFrequency(SourceFilter As String) As Long

The GetAudioFrequency method retrieves the currently tuned audio frequency.

Parameter:

SourceFilter

Name of the source filter.

C Prototype:

HRESULT GetAudioFrequency(BSTR SourceFilter, LONG* value);

Method IMVSCTVTuner::GetAvailableModes

Declaration: Function GetAvailableModes(SourceFilter As String) As Long

The GetAvailableModes method retrieves the tuner's supported modes.

Parameter:

SourceFilter

Name of the source filter.

C Prototype:

HRESULT GetAvailableModes(BSTR SourceFilter, LONG* value);

Method IMVSCTVTuner::GetAvailableTunerTVFormats

Declaration: Function GetAvailableTunerTVFormats(SourceFilter As String) As Long

The GetAvailableTunerTVFormats method retrieves all the analog video TV standards that the tuner supports.

Parameter:

SourceFilter

Name of the source filter.

C Prototype:

HRESULT GetAvailableTunerTVFormats(BSTR SourceFilter, LONG* value);

Method IMVSCTVTuner::GetChannel

Declaration: Sub GetChannel(SourceFilter As String, Channel As Long, VideoSubChannel As Long, AudioSubChannel As Long)

The GetChannel method retrieves the channel to which the tuner is set.

Parameter:

	SourceFilter	Name of the source filter.
	Channel	Receives the channel.
	VideoSubChannel	Receives the video subchannel.
	AudioSubChannel	Receives the audio subchannel.

The subchannel values could also set one of the following values.

Name	Value	Description
MV_TUNER_SUBCHAN_DEFAULT	-1	Default subchannel
MV_TUNER_SUBCHAN_NO_TUNE	-2	No subchannel tuning

C Prototype:

HRESULT GetChannel(BSTR SourceFilter, LONG Channel, LONG* VideoSubChannel, LONG* AudioSubChannel);

Method IMVSCTVTuner::GetConnectInput

Declaration: Function GetConnectInput(SourceFilter As String) As Long

The GetConnectInput method retrieves the hardware tuner input connection.

Parameter:

SourceFilter

Name of the source filter.

C Prototype:

HRESULT GetConnectInput(BSTR SourceFilter, LONG* value);

Method IMVSCTVTuner::GetCountryCode

Declaration: Function GetCountryCode(SourceFilter As String) As Long

The GetCountryCode method retrieves the country/region code that establishes the current channel-to-frequency mapping.

Parameter:

SourceFilter

Name of the source filter.

C Prototype:

HRESULT GetCountryCode(BSTR SourceFilter, LONG* value);

Method IMVSCTVTuner::GetInputType

Declaration: Function GetInputType(SourceFilter As String, Index As Long) As Long

The GetInputType method retrieves the input type.

Parameter:

	SourceFilter	Name of the source filter.
	Index	Index value that specifies the input pin that will be set.

C Prototype:

HRESULT GetInputType(BSTR SourceFilter, LONG Index, LONG* value);

Method IMVSCTVTuner::GetNumInputConnections

Declaration: Function GetNumInputConnections(SourceFilter As String) As Long

The GetNumInputConnections method retrieves the number of TV sources plugged into the tuner filter.

Parameter:

SourceFilter

Name of the source filter.

C Prototype:

HRESULT GetNumInputConnections(BSTR SourceFilter, LONG* value);

Method IMVSCTVTuner::GetTunerMode

Declaration: Function GetTunerMode(SourceFilter As String) As Long

The GetTunerMode method retrieves the current mode on a multifunction tuner.

Parameter:

SourceFilter

Name of the source filter.

C Prototype:

HRESULT GetTunerMode(BSTR SourceFilter, LONG* value);

Method IMVSCTVTuner::GetTunerTVFormat

Declaration: Function GetTunerTVFormat(SourceFilter As String) As Long

The GetTunerTVFormat method retrieves the current analog video TV standard in use.

Parameter:

SourceFilter

Name of the source filter.

C Prototype:

HRESULT GetTunerTVFormat(BSTR SourceFilter, LONG* value);

Method IMVSCTVTuner::GetTuningSpace

Declaration: Function GetTuningSpace(SourceFilter As String) As Long

The GetTuningSpace method retrieves the tuning space.

Parameter:

SourceFilter

Name of the source filter.

C Prototype:

HRESULT GetTuningSpace(BSTR SourceFilter, LONG* value);

Method IMVSCTVTuner::GetVideoFrequency

Declaration: Function GetVideoFrequency(SourceFilter As String) As Long

The GetVideoFrequency method retrieves the current video frequency.

Parameter:

SourceFilter

Name of the source filter.

C Prototype:

HRESULT GetVideoFrequency(BSTR SourceFilter, LONG* value);

Method IMVSCTVTuner::IsTVTunerAvailable

Declaration: Function IsTVTunerAvailable(SourceFilter As String) As Boolean

Check if the TV tuner device is avaiable for a source filter.

Parameter:

SourceFilter

Name of the source filter.

C Prototype:

HRESULT IsTVTunerAvailable(BSTR SourceFilter, VARIANT_BOOL* value);

Method IMVSCTVTuner::RegisterNotificationCallBack

Declaration: Sub RegisterNotificationCallBack(SourceFilter As String, UnkNotify As Unknown, Events As Long)

The RegisterNotificationCallBack method enables an object to receive event notifications when the tuner changes state. This method is not implemented.

Parameter:

	SourceFilter	Name of the source filter.
	UnkNotify	Pointer to the IUnknown pointer of a IAMTunerNotification interface that will receive the event notifications.
	Events	Flag indicating that an event has occurred.

C Prototype:

HRESULT RegisterNotificationCallBack(BSTR SourceFilter, UNKNOWN UnkNotify, LONG Events);

Method IMVSCTVTuner::SetChannel

Declaration: Sub SetChannel(SourceFilter As String, Channel As Long, VideoSubChannel As Long, AudioSubChannel As Long)

The SetChannel method sets the TV channel.

Parameter:

	SourceFilter	Name of the source filter.
	Channel	TV channel number.
	VideoSubChannel	Predefined video subchannel value. Specify MV_TUNER_SUBCHAN_NO_TUNE for no tuning or MV_TUNER_SUBCHAN_DEFAULT for default subchannel. Meaningful only for satellite broadcasts.
	AudioSubChannel	Predefined audio subchannel value. Specify MV_TUNER_SUBCHAN_NO_TUNE for no tuning or MV_TUNER_SUBCHAN_DEFAULT for default subchannel. Meaningful only for satellite broadcasts.

C Prototype:

HRESULT SetChannel(BSTR SourceFilter, LONG Channel, LONG VideoSubChannel, LONG AudioSubChannel);

Method IMVSCTVTuner::SetConnectInput

Declaration: Sub SetConnectInput(SourceFilter As String, Index As Long)

The SetConnectInput method sets the hardware tuner input connection.

Parameter:

	SourceFilter	Name of the source filter.
	Index	Index value of the input pin to set connection for.

C Prototype:

HRESULT SetConnectInput(BSTR SourceFilter, LONG Index);

Method IMVSCTVTuner::SetCountryCode

Declaration: Sub SetCountryCode(SourceFilter As String, CountryCode As Long)

The SetCountryCode method sets the country/region code to establish the frequency to use.

Parameter:

	SourceFilter	Name of the source filter.
	CountryCode	Value indicating the country/region code.

C Prototype:

HRESULT SetCountryCode(BSTR SourceFilter, LONG CountryCode);

Method IMVSCTVTuner::SetInputType

Declaration: Sub SetInputType(SourceFilter As String, Index As Long, InputType As Long)

The SetInputType method sets the tuner input type (cable or antenna).

Parameter:

	SourceFilter	Name of the source filter.
	Index	Index value that specifies the input pin to be set.
	InputType	Value indicating the connection type.

C Prototype:

HRESULT SetInputType(BSTR SourceFilter, LONG Index, LONG InputType);

Method IMVSCTVTuner::SetTunerMode

Declaration: Sub SetTunerMode(SourceFilter As String, TunerMode As Long)

The SetMode method sets a multifunction tuner to the specified mode.

Parameter:

	SourceFilter	Name of the source filter.
	TunerMode	Flag indicating which mode to switch to.

C Prototype:

HRESULT SetTunerMode(BSTR SourceFilter, LONG TunerMode);

Method IMVSCTVTuner::SetTuningSpace

Declaration: Sub SetTuningSpace(SourceFilter As String, TuningSpace As Long)

The SetTuningSpace method sets a storage index for regional channel-to-frequency mappings.

Parameter:

	SourceFilter	Name of the source filter.
	TuningSpace	Value indicating the current locale.

C Prototype:

HRESULT SetTuningSpace(BSTR SourceFilter, LONG TuningSpace);

Method IMVSCTVTuner::SignalPresent

Declaration: Function SignalPresent(SourceFilter As String) As Long

The SignalPresent method retrieves the strength of the signal on a given channel.

Signal	Value
MV_TUNER_HASNOSIGNALSTRENGTH	-1
MV_TUNER_NOSIGNAL	0
MV_TUNER_SIGNALPRESENT	1

Parameter:

SourceFilter

Name of the source filter.

C Prototype:

HRESULT SignalPresent(BSTR SourceFilter, LONG* value);

Method IMVSCTVTuner::StoreAutoTune

Declaration: Sub StoreAutoTune(SourceFilter As String)

The StoreAutoTune method saves the fine-tuning information for all channels.

Parameter:

SourceFilter

Name of the source filter.

C Prototype:

HRESULT StoreAutoTune(BSTR SourceFilter);

Method IMVSCTVTuner::TVTunerLogon

Declaration: Sub TVTunerLogon(SourceFilter As String, CurrentUser As Long)

The Logon method logs a user onto the system.

Parameter:

	SourceFilter	Name of the source filter.
	CurrentUser	Handle to an application-defined data structure that identifies the current user.

C Prototype:

HRESULT TVTunerLogon(BSTR SourceFilter, LONG CurrentUser);

Method IMVSCTVTuner::TVTunerLogout

Declaration: Sub TVTunerLogout(SourceFilter As String)

The Logout method logs out the current user.

Parameter:

SourceFilter

Name of the source filter.

C Prototype:

HRESULT TVTunerLogout(BSTR SourceFilter);

Method IMVSCTVTuner::UnRegisterNotificationCallBack

Declaration: Sub UnRegisterNotificationCallBack(SourceFilter As String, UnkNotify As Unknown)

The UnRegisterNotificationCallBack method unregisters an object for event notifications. This method is not implemented.

Parameter:

	SourceFilter	Name of the source filter.
	UnkNotify	Pointer to the IUnknown pointer of a IAMTunerNotification interface that will receive the event notifications.

C Prototype:

HRESULT UnRegisterNotificationCallBack(BSTR SourceFilter, UNKNOWN UnkNotify);