IDXRawSurface Interface

The IDXRawSurface interface is used to implement custom surface types that are not based on Microsoft® DirectDraw® surfaces—these are called custom raw surfaces. This interface enables a custom raw surface to be accessed as a DXSurface through the IDXSurface interface.

A nonprocedural DXSurface object must be associated with an underlying piece of memory that contains pixel data, such as an application memory buffer or a DIBSECTION structure. To use a custom memory object, you must create a simple COM object that implements the IDXRawSurface interface and manages the lifetime of the underlying pixel memory buffer. The IDXRawSurface::GetSurfaceInfo method retrieves information about the structure of the pixel memory. When the DXSurface no longer needs the custom raw surface object, it will do the final release. When the raw surface's reference count reaches zero, it should free all its resources before deleting itself.

This interface inherits from the IUnknown interface.

IDXRawSurface Method

GetSurfaceInfo Retrieves information about the attributes and structure of the raw surface object's pixel data.

IDXRawSurface::GetSurfaceInfo

IDXRawSurface Interface

Retrieves information about the attributes and structure of the raw surface object's pixel data.

Syntax

HRESULT GetSurfaceInfo(
    DXRAWSURFACEINFO *pSurfaceInfo
);

Parameters

pSurfaceInfo
Pointer to the surface description.

Return Value

Returns an HRESULT value that depends on the implementation of the interface.