IWiaVideo::CreateVideoByName method (wiavideo.h)

The IWiaVideo::CreateVideoByName method creates a connection to a streaming video device with the friendly device name obtained from a Directshow enumeration.

Syntax

HRESULT CreateVideoByName(
  [in] BSTR bstrFriendlyName,
  [in] HWND hwndParent,
  [in] BOOL bStretchToFitParent,
  [in] BOOL bAutoBeginPlayback
);

Parameters

[in] bstrFriendlyName

Type: BSTR

Specifies the video device's friendly name obtained from a Directshow device enumeration.

[in] hwndParent

Type: HWND

Specifies the window in which to display the streaming video.

[in] bStretchToFitParent

Type: BOOL

Specifies whether the video display is stretched to fit the parent window. Set this parameter to TRUE if the display should be stretched to fit the parent window; otherwise, set to FALSE.

[in] bAutoBeginPlayback

Type: BOOL

Specifies whether the streaming video begins playback as soon as this method returns. Set this parameter to TRUE to cause immediate playback; set it to FALSE to require a call to IWiaVideo::Play before video playback begins.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

By default, the video is displayed in the video device's default resolution. If bStretchToFitParent is set to TRUE, the video display fills the window.

Requirements