|
IMVSCTVTuner
The IMVSCTVTuner interface contains methods and properties to
configure a TV tuner device.
Methods:
| ChannelMinMax
|
The ChannelMinMax method retrieves the highest and lowest
channels available. |
| GetAudioFrequency
|
The GetAudioFrequency method retrieves the currently tuned
audio frequency. |
| GetAvailableModes
|
The GetAvailableModes method retrieves the tuner's supported
modes. |
| GetAvailableTunerTVFormats
|
The GetAvailableTunerTVFormats method retrieves all the analog
video TV standards that the tuner supports. |
| GetChannel
|
The GetChannel method retrieves the channel to which the tuner
is set. |
| GetConnectInput
|
The GetConnectInput method retrieves the hardware tuner input
connection. |
| GetCountryCode
|
The GetCountryCode method retrieves the country/region code
that establishes the current channel-to-frequency mapping. |
| GetInputType
|
The GetInputType method retrieves the input type. |
| GetNumInputConnections
|
The GetNumInputConnections method retrieves the number of TV
sources plugged into the tuner filter. |
| GetTunerMode
|
The GetTunerMode method retrieves the current mode on a
multifunction tuner. |
| GetTunerTVFormat
|
The GetTunerTVFormat method retrieves the current analog video
TV standard in use. |
| GetTuningSpace
|
The GetTuningSpace method retrieves the tuning space. |
| GetVideoFrequency
|
The GetVideoFrequency method retrieves the current video
frequency. |
| IsTVTunerAvailable
|
Check if the TV tuner device is avaiable for a source
filter. |
| RegisterNotificationCallBack
|
The RegisterNotificationCallBack method enables an object to
receive event notifications when the tuner changes state. This
method is not implemented. |
| SetChannel
|
The SetChannel method sets the TV channel. |
| SetConnectInput
|
The SetConnectInput method sets the hardware tuner input
connection. |
| SetCountryCode
|
The SetCountryCode method sets the country/region code to
establish the frequency to use. |
| SetInputType
|
The SetInputType method sets the tuner input type (cable or
antenna). |
| SetTunerMode
|
The SetMode method sets a multifunction tuner to the specified
mode. |
| SetTuningSpace
|
The SetTuningSpace method sets a storage index for regional
channel-to-frequency mappings. |
| SignalPresent
|
The SignalPresent method retrieves the strength of the signal
on a given channel. |
| StoreAutoTune
|
The StoreAutoTune method saves the fine-tuning information for
all channels. |
| TVTunerLogon
|
The Logon method logs a user onto the system. |
| TVTunerLogout
|
The Logout method logs out the current user. |
| UnRegisterNotificationCallBack
|
The UnRegisterNotificationCallBack method unregisters an object
for event notifications. This method is not implemented. |
Typelib: MV SmartControl
Analog Video Standard Table
| Video Standard
|
Value
|
Description
|
| MV_VIDEOSTANDARD_NONE |
0x00000000
|
|
| MV_VIDEOSTANDARD_NTSC_M |
0x00000001
|
NTSC (M) standard, 7.5 IRE black |
|
MV_VIDEOSTANDARD_NTSC_M_J |
0x00000002
|
NTSC (M) standard, 0 IRE black (Japan)
|
| MV_VIDEOSTANDARD_NTSC_433 |
0x00000004
|
NTSC-433
|
| MV_VIDEOSTANDARD_PAL_B |
0x00000010
|
PAL-B standard |
|
MV_VIDEOSTANDARD_PAL_D
|
0x00000020
|
PAL (D) standard |
| MV_VIDEOSTANDARD_PAL_H |
0x00000080
|
PAL (H) standard |
| MV_VIDEOSTANDARD_PAL_I |
0x00000100
|
PAL (I) standard |
| MV_VIDEOSTANDARD_PAL_M |
0x00000200
|
PAL (M) standard |
| MV_VIDEOSTANDARD_PAL_N |
0x00000400
|
PAL (N) standard
|
| MV_VIDEOSTANDARD_PAL_60 |
0x00000800
|
PAL-60 standard |
| MV_VIDEOSTANDARD_SECAM_B |
0x00001000
|
SECAM (B) standard |
| MV_VIDEOSTANDARD_SECAM_D |
0x00002000
|
SECAM (D) standard |
| MV_VIDEOSTANDARD_SECAM_G |
0x00004000
|
SECAM (G) standard |
| MV_VIDEOSTANDARD_SECAM_H |
0x00008000
|
SECAM (H) standard |
| MV_VIDEOSTANDARD_SECAM_K |
0x00010000
|
SECAM (K) standard |
| MV_VIDEOSTANDARD_SECAM_K1 |
0x00020000
|
SECAM (K1) standard |
| MV_VIDEOSTANDARD_SECAM_L |
0x00040000
|
SECAM (L) standard |
| MV_VIDEOSTANDARD_SECAM_L1 |
0x00080000
|
SECAM (L1) standard |
| MV_VIDEOSTANDARD_PAL_N_COMBO |
0x00100000
|
Combination (N) PAL standard (Argentina) |
TV Tuner
Modes
| Mode
|
Value
|
Desription
|
| MV_TUNER_MODE_DEFAULT |
0
|
Indicates default tuner mode. |
| MV_TUNER_MODE_TV |
1
|
Indicates TV tuner mode. |
| MV_TUNER_MODE_FM_RADIO |
2
|
Indicates FM radio tuner mode. |
| MV_TUNER_MODE_AM_RADIO |
4
|
Indicates AM radio tuner mode.
|
| MV_TUNER_MODE_DSS |
8
|
Indicates Digital Satellite Service (DSS) tuner mode. |
| MV_TUNER_MODE_DTV |
16
|
Indicates Digital TV tuner mode. |
TV Tuner Input Type
| Type
|
Value
|
Desciption
|
| MV_TUNER_INPUT_CABLE |
0
|
Indicates cable frequency. |
| MV_TUNER_INPUT_ANTENNA |
1
|
Indicates broadcast antenna frequency. |
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);
|
