IMSVidCtl::ViewNext Method

This topic applies to Windows XP or later.
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(
  [in]  VARIANT *pv
);

Parameters

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

Return Value

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.)

Requirements

See Also

IMSVidCtl Interface
IMSVidCtl::View

Send comments about this topic to Microsoft

Build date: 12/4/2008