IAMVideoAccelerator::GetUncompFormatsSupported

  • Article
 
Microsoft DirectShow 9.0

IAMVideoAccelerator::GetUncompFormatsSupported

The GetUncompFormatsSupported method retrieves a list of pixel formats that can be used to render a specified video accelerator format.

Syntax

  HRESULT GetUncompFormatsSupported(
  const GUID *pGuid,
  LPDWORD pdwNumFormatsSupported,
  LPDDPIXELFORMAT pFormatsSupported
);

Parameters

pGuid

[in] Pointer to a video accelerator GUID.

pdwNumFormatsSupported

[in] [out] If pFormatsSupported is NULL, pdwNumFormatsSupported returns with the number of pixel formats to which the video accelerator format, defined by pGuid, can be converted. Otherwise, this parameter is the number of pixel formats to return in pFormatsSupported. When the method returns, this parameter is the actual number of pixel formats returned.

pFormatsSupported

[in] [out] Pointer to a DDPIXELFORMAT structure. If this parameter is not NULL, up to *pdwNumFormatsSupported pixel formats are copied into this array. The size of the buffer should be at least *pdwNumFormatsSupported * sizeof(DDPIXELFORMAT).

Return Values

Returns S_OK when successful. Otherwise an error code is returned.

Note:The driver can return DDERR_MOREDATA if fewer than the total number of formats are requested.  DDERR_MOREDATA is technically a failing HRESULT which will be caught by SUCCEEDED() or FAILED() macros but it isn't really a failure. The decoder must handle this result specially.

Requirements

Header: Include videoacc.h.

Library: Use Strmiids.lib.

See Also