[This is preliminary documentation and subject to change.]
The Tune method tunes the WebTV for Windows display to the specified channel.
HRESULT Tune(
long lTuningSpace,
long lChannelNumber,
long lVideoStream,
long lAudioStream,
BSTR bsIPStream
);
This functionality is useful because, for example, a television station with a Hispanic audience might define a Spanish-language audio stream as the default but also define an English-language version as an alternate audio stream. To access the English-language version in this case, an application passes the audio stream identifier that the content provider specifies for that version.
The preloadURL and overlayCSS parameters are optional, and can be left out of the string. For example, "255.255.255.255 123.25.433.1:1701".
If no trigger stream exists, this value is set to NULL.
Returns an HRESULT indicating success or failure. If the method succeeds it returns S_OK. Otherwise it returns an error code. For specific error code values see Winerror.h.
Windows NT: Unsupported.
Windows: Requires Windows 98.
Windows CE: Unsupported.
Header: Declared in tvdisp.odl.
Import Library: Included as a resource in tvx.exe.
Unicode: Yes.
ITVViewer::GetCurrentTuningInfo, ITVViewer::GetPreviousTuningInfo, ITVControl::Tune