IDXRawSurface Interface

IID_IDXRawSurface

{09756C8A-D96A-11d1-9062-00C04FD9189D}

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.

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.
 

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IDXRawSurface Members

Description

GetSurfaceInfo

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

GetSurfaceInfo

FUNCTION IDXRawSurface_GetSurfaceInfo ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pSurfaceInfo AS DXRAWSURFACEINFO _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING IDXRawSurface_GetSurfaceInfo (pthis, pSurfaceInfo) TO HRESULT
  FUNCTION = HRESULT
 

END FUNCTION