Microsoft DirectX 8.1 (C++) |
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