IDDVideoPortContainer::CreateVideoPort

This method creates a DirectDrawVideoPort object.

HRESULT CreateVideoPort(
  DWORD dwFlags, 
  LPDDVIDEOPORTDESC lpDDVideoPortDesc, 
  LPDIRECTDRAWVIDEOPORT FAR* lplpDDVideoPort, 
  IUnknown FAR* pUnkOuter
);

Parameters

• dwFlags
  Flags specifying video-port control options. This parameter can be one of the following flags, or NULL if control options are not needed.

  Flag	Description
  DDVPCREATE_VBIONLY	The process controls the VBI portion of the video stream.
  DDVPCREATE_VIDEOONLY	The process controls the non-VBI (video) portion of the video stream.

• lpDDVideoPortDesc
  Address of a DDVIDEOPORTDESC structure that describes the DirectDrawVideoPort object to be created.
• lplpDDVideoPort
  Address of a variable that will be filled with a pointer to the new DirectDrawVideoPort object's IDirectDrawVideoPort interface if the call succeeds.
• pUnkOuter
  Allows for future compatibility with COM aggregation features. Presently, this method will return an error if this parameter is other than NULL.

Return Values

If the method succeeds, the return value is DD_OK.

If the method fails, the return value may be one of the following error values:

Requirements

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Dvp.h.
Link Library: Ddraw.lib.

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.