ITVViewer::GetPreviousTuningInfo

[This is preliminary documentation and subject to change.]

The GetPreviousTuningInfo method returns information about the channel to which WebTV for Windows was previously tuned.

HRESULT GetPreviousTuningInfo(
  long *lTuningSpace,    
  long *lChannelNumber,  
  long *IVideoStream,    
  long *lAudioStream,    
  BSTR *pbsIPAddress     
);
 

Parameters

lTuningSpace

Pointer to a long that receives the tuning space identifier of the previous channel.

lChannelNumber

Pointer to a long that receive the channel number of the previous channel.

IVideoStream

Pointer to a long that receives the identifier of the previous video stream.

lAudioStream

Pointer to a long that receives the identifier of the previous audio stream.

psbIPAddress

Pointer to a BSTR that receives the IP address on which triggers were sent for the previous channel. This address should in the format xxx.xxx.xxx.xxx\tyyy, where xxx.xxx.xxx.xxx specifies the IP address, and yyy specifies the port. The IP address and the port values are separated by a tab character, for example 255.255.255.255\t999.

This parameter must be initialized to NULL when you pass it to the method; otherwise. the method returns an OLE exception.

Return Values

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.

Remarks

This method only returns information about the single channel tuned to just previous to the current channel. It cannot be used to retrieve information about channels tuned to before that.

QuickInfo

  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.

See Also

ITVViewer::GetCurrentTuningInfo, ITVViewer::Tune