| Parameters
| winid |
|
| Frequency | This is the tuner frequency to which the dvbs modulator- tuner should tune. Its range is 950 upto 1275 MHz (FreqMin FreqMax). In case of a search action it is the center frequency of the range in which a transmission should be searched for.
|
| SearchRange | By setting its value to SearchRangeTune (0) a lock attempt is made to a channel which is at the given Frequency (or in the near neighbourhoud of it).
Setting its value in between SearchRangeMin and SearchRangeMax will start a search algo that will find a broadcast in the given range around the given Frequency, so a broadcast will be searched for in a region of SearchRange/2 around Frequency.
|
| SymbolRate | In case of a tune request, this value should be set to a value in between SymbRateMin SymbRateMax.
In case of a search request the value should either be SymbRateUnknown or a value in between SymbRateMin SymbRateMax. In the last case, the decoder will search for a broadcast with a symbol rate of at least the given value.
|
| ModulationStandard | This can either be an explicit value ModulationStandardDvbXXX or a ModulationStandardUnknown. Setting ModulationStandard to an explicit value will speed up the acquisition time.
|
| ModulationType | This can either be an explicit value ModulationTypeXXX or a ModulationTypeUnknown. Setting ModulationType to an explicit value will speed up the acquisition time
|
| CodeRate | (Also known as guard interval). This can either be an explicit value CodeRateXXX or a CodeRateUnknown. Setting CodeRate to an explicit value will speed up the acquisition time.
|
| PunctureRate | This can either be an explicit value PunctureRateXXX or a PunctureRateUnknown. Setting it PunctureRate to an explicit value might (1) speed up the acquisition time.
|
| IQMode | This can either be an explicit value IQModeNormal or IQModeInversed or a IQModeUnknown. Setting IQMode to an explicit value might (1) speed up the acquisition time
|
| Timeout | If this address is not NULL, the implementation will fill in the time (in msec) after which a notification will be sent at latest.
|
| Cookie | This cookie is used to link an OnLockChanged notification to an AttempLlock call, so to easier identify a demodulation answer with the request.
|
| CmdResult | This variable if not NULL will contain the functional result.
CmdResultLocking the function has been called correctly, and the lock attempt is ongoing; a notification will follow.
CmdResultInvalidParameter one or more of the parameters are invalid
CmdResultInvalidState the command was not called in the correct state, this can happen when the dvbs use case was not selected.
CmdResultLocked a lock has been detected immediately (no notify will follow)
| Returnvalue | | Returns the result of making the interface call
| |
| Parameters
| winid |
|
| Frequency | This is the actual tuner frequency to which the dvbs modulator- tuner has tuned. Its range is 950 upto 1275 MHz (FreqMin FreqMax). It might slightly differ from the requested frequency due to drift on the LNB. In case of a search request it is a frequency where a transmission was found.
|
| SymbolRate | The value of the SymbolRate of the signal to which the decoder is locked. It will range in between SymbRateMin SymbRateMax.
|
| ModulationStandard | This the value of the ModulationStandard of the signal where the decoder is locked into. It will be one of the constant values ModulationStandardDvbXXX.
|
| ModulationType | This the value of the ModulationType of the signal to which the decoder is locked. It will be one of the constant values ModulationTypeXXX.
|
| CodeRate | This the value of the CodeRate of the signal to which the decoder is locked. It will be one of the constant values CodeRateXXX.
|
| PunctureRate | This the value of the PunctureRate of the signal to which the decoder is locked. It will be one of the constant values PunctureRateXXX
|
| IQMode | This the value of the IQMode (SpectrumInversion) of the signal to which the decoder is locked. This can either be IQModeNormal or QModeInversed .
|
| LockState | This value reflects if the decoder is locked or not. Its value is one of the constants LockStateXXX.
|
| CmdResult | This variable if not NULL will contain the functional result.
CmdResultOK the function has been called correctly.
CmdResultInvalidParameter one or more of the parameters are invalid (NULL pointer)
CmdResultInvalidState the command was not called in the correct state, this can happen when the dvbs use case was not selected or no lock attemp was yet made.
| Returnvalue | | The return value reflects the non functional result of making the API call (see general api description)
| |