IBDA_DiseqCommand::put_DiseqUseToneBurst method (bdaiface.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

Enables or disables Tone-Burst commands.

Syntax

HRESULT put_DiseqUseToneBurst(
  [in] BOOLEAN bUseToneBurst
);

Parameters

[in] bUseToneBurst

If TRUE, Tone-Burst commands are enabled. Otherwise, Tone-Burst commands are disabled.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The Tone-Burst command uses a 22-kHz carrier signal to select either source position A or source position B.

Typically the driver enables or disables Tone-Burst as needed when the application calls IBDA_DiseqCommand::put_DiseqLNBSource. However, you can use the put_DiseqUseToneBurst method to switch this mode on or off, either to improve channel switching or to maintain compatibility with particular equipment. Note that using Tone-Burst can increase the amount of time required for tuning by about 40 milliseconds.

Requirements

See also

IBDA_DiseqCommand