IDDVideoPortContainer::CreateVideoPort

The IDDVideoPortContainer::CreateVideoPort 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:

DDVPCREATE_VBIONLY	The process only wants to control the VBI portion of the video stream.
DDVPCREATE_VIDEOONLY	The process only wants to control the non-VBI (video) portion of the video stream.

lpDDVideoPortDesc

Address of a DDVIDEOPORTDESC structure that describes the VideoPort 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, however, this method will return an error if this parameter is anything but 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:

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in dvp.h.
  Import Library: Use ddraw.lib.