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 wants to control only the VBI portion of the video stream.

DDVPCREATE_VIDEOONLY

The process wants to control only 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 to 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 returns an error if this parameter is anything but NULL.

Return Values

If the method succeeds, the return value is DD_OK.

If it fails, the method can return one of the following error values:

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dvp.h.
  Import Library: Use ddraw.lib.