TunerSeekStation

This function begins seeking for a frequency with a sufficiently strong signal.

Syntax

BOOL TunerSeekStation( HANDLE hTuner, PTUNERSEEKINFO pTunerSeekInfo );

Parameters

hTuner

[in] Handle to the current tuner, as returned by TunerOpen.

pTunerSeekInfo

[in] Pointer to a TUNERSEEKINFO structure that contains information on the specified frequency search range and direction.

Return Values

TRUE indicates success. FALSE indicates failure.

Remarks

The fnCallBack member of the TUNERSEEKINFO structure that you pass to this function identifies a callback function. The device driver calls the callback function to inform the application of the frequency that the seek operation has reached, using SIGNALINFO structure as one of the parameters in the callback function. You can use this information about the frequency to update the user interface (UI). Providing a pointer to this function allows the device driver to call the callback function periodically during the seek operation. The frequency at which the device driver calls the callback function depends on the device driver.

The tuner stops the seek operation when the tuner finds a station with a sufficiently strong signal.

See Also

TUNERSEEKINFO, SIGNALINFO