MSVidCtl.View

Microsoft DirectX 8.1 (C++)

MSVidCtl.View

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

The View method configures an input device for a specified tune request.

Syntax

objMSVidCtl.View(
    v As Object
)

Parameters

Specifies the tune request as an ITuneRequest object.

Error Codes

If the method fails, an error is raised and Err.Number is set to a value other than zero.

Remarks

If the Video Control already has an active input device, this method configures the device for the specified tune request. Otherwise, this method locates an input device that can handle the tune request and activates it.

An input device typically corresponds to a source filter. The Video Control determines which filter to use by examining the network type on the tune request. For digital television, the input device will be a BDA Network Provider filter. For analog television, it will be a WDM TV Tuner filter. The specific name and implementation of the filter are device-dependent.

After calling View, build and run the filter graph, using the following methods:

The MSVidCtl.Build method builds the rest of the filter graph, based on the selected input and the active features collection. The Build method leaves the graph in a stopped state.
The MSVidCtl.Run method calls Build if the graph is not built, and puts the graph into a running state. When the filter graph runs, the video control starts playing the specified tune request.

If the filter graph is already built and running, an application can call View to specify a new tune request, either on the same network type or on a different network type.

You can specify a particular input device by setting the MSVidCtl.InputActive property and then calling IMSVidInputDevice.View on the device, instead of calling View on the Video Control. This might be useful if the local system has multiple devices of the same type. The MSVidCtl.View method is preferred, however, because it automatically locates the correct device type.

See Also