IDXRawSurface interface

  • Article

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

Members

The IDXRawSurface interface inherits from the IUnknown interface. IDXRawSurface also has these types of members:

  • Methods

Methods

The IDXRawSurface interface has these methods.

Method Description
GetSurfaceInfo

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

 

Remarks

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 Component Object Model (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.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

 Dxtrans.h

IDL

 Dxtrans.idl

DLL

 Dxtrans.dll