Share via

IDDVideoPortContainer::CreateVideoPort

  • Article

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:

DDERR_CURRENTLYNOTAVAIL
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_NOCOOPERATIVELEVELSET
DDERR_OUTOFCAPS
DDERR_OUTOFMEMORY

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.