IMSVidCtl::ViewNext

This topic applies to Windows XP Home Edition and Windows XP Professional only.

The ViewNext method finds another input device to view the specified tune request.

This method is supported only for analog tuner devices. It does not work with digital tuners.

Syntax

HRESULT ViewNext(
  VARIANT*  pv
);

Parameters

  pv

[in]  Specifies the tune request as a VARIANT type.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

This method works like the IMSVidCtl::View method, with the following difference: If the system has more than one tuner that supports the specified network type, the ViewNext method skips the current input device and uses the next one. (The ordering of devices is arbitrary.)

See Also

• IMSVidCtl Interface
• IMSVidCtl::View