ITVViewer::GetCurrentTuningInfo

[This is preliminary documentation and subject to change.]

The GetCurrentTuningInfo method returns information about the channel to which WebTV for Windows is currently tuned.

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

Parameters

lTuningSpace

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

lChannelNumber

Pointer to a long that receives the current channel number.

IVideoStream

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

lAudioStream

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

pbsIPAddress

Pointer to a BSTR that receives the current IP address WebTV for Windows is monitoring for triggers. This address should be 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; 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.

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::GetPreviousTuningInfo, ITVViewer::Tune