Microsoft DirectX 8.1 (C++)

IAMVideoAccelerator::GetCompBufferInfo

The GetCompBufferInfo method retrieves compressed buffer information.

Syntax

HRESULT GetCompBufferInfo(
  const GUID *pGuid,
  const AMVAUncompDataInfo *pamvaUncompDataInfo,
  LPDWORD pdwNumTypesCompBuffers,
  LPAMVACompBufferInfo pamvaCompBufferInfo
);

Parameters

pGuid

[in] Pointer to a video accelerator format GUID.

pamvaUncompDataInfo

[in] Pointer to an AMVAUncompDataInfo structure containing the size and pixel format of the uncompressed data.

pdwNumTypesCompBuffers

[in] [out] Pointer to a variable of type DWORD. If pamvaCompBufferInfo is not NULL, this parameter receives the number of uncompressed buffer types. Otherwise, on input this parameter specifies the maximum number of compressed buffer types to return, and on output receives the actual number of compressed buffer types.

pamvaCompBufferInfo

[out] If non-NULL, then up to pdwNumTypesCompBuffers AMVACompBufferInfo structure are returned. This data includes the width, height, pixel format, and DirectDraw capabilities to be used to create the surface and the size in bytes the surface will occupy.

Return Values

Returns an HRESULT value that depends on the implementation of the interface. HRESULT can include one of the following standard constants, or other values not listed.

Return code Description
E_FAIL Failure.
E_INVALIDARG Argument is invalid.
E_NOTIMPL Method is not supported.
E_POINTER Null pointer argument.
S_OK Success.

Remarks

This method returns the information necessary to create a video accelerator surface of the required type using DirectDraw. A video accelerator driver may support multiple compressed buffer types (for instance, video accelerator data and Inverse Discrete Cosine Transfer [IDCT] data).

See Also