IDirectDrawVideoPort::GetOutputFormats

This method retrieves a list of output formats that the DirectDrawVideoPort object supports for a specified input format.

HRESULT GetOutputFormats( 
  LPDDPIXELFORMAT lpInputFormat, 
  LPDWORD lpNumFormats, 
  LPDDPIXELFORMAT lpFormats, 
  DWORD dwFlags
); 

Parameters

• lpInputFormat
  Address of a DDPIXELFORMAT structure that describes the input format for which conversion information is requested.
• lpNumFormats
  Address of a variable containing the number of entries that the array at lpFromats can hold. If this number is less than the total number of codes, the method fills the array with as many codes as will fit, sets the value at lpNumFormats to indicate the total number of codes, and returns DDERR_MOREDATA.
• lpFormats
  Address of an array of DDPIXELFORMAT structures that will be filled in with the output formats supported by this DirectDrawVideoPort object. If this parameter is NULL, the method sets lpNumFormats to the number of supported formats and then returns DD_OK.
• dwFlags
  Flags specifying the part of the video signal for which formats will be enumerated. The following table shows the possible flags.

  Flag	Description
  DDVPFORMAT_VIDEO	Returns formats for the video data.
  DDVPFORMAT_VBI	Returns formats for the VBI data.

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.