IDirectDrawVideoPort::SetTargetSurface

This method sets the DirectDrawSurface object that will receive the stream of live video data and/or the vertical blank interval data.

HRESULT SetTargetSurface( 
  LPDIRECTDRAWSURFACE lpDDSurface, 
  DWORD dwFlags
); 

Parameters

• lpDDSurface
  Address of the DirectDrawSurface object that will receive the video data.
• dwFlags
  Value specifying the type of target surface. The following table shows the possible flags.

  Flag	Description
  DDVPTARGET_VIDEO	The specified surface should receive the normal video data and vertical interval data unless a separate surface was attached for this purpose.
  DDVPTARGET_VBI	The specified surface should receive the data within the vertical blanking interval.

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.

See Also

IDirectDrawVideoPort::StartVideo | IDirectDrawVideoPort::StopVideo | IDirectDrawVideoPort::UpdateVideo

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.