IDXSurfaceFactory interface

  • Article

The IDXSurfaceFactory interface provides methods to create and load data into DXSurface data objects.

Members

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

  • Methods

Methods

The IDXSurfaceFactory interface has these methods.

Method Description
BitBlt

Copies samples from one DXSurface to another.
CopySurfaceToNewFormat

Copies one surface to another and changes its pixel format.
CreateD3DRMTexture
CreateFromDDSurface

Creates a DXSurface that contains a specified DirectDrawSurface object.
CreateSurface

Creates a DXSurface object of the specified size and format.
LoadImage

Binds the specified file name or URL and returns a DXSurface containing the image data.
LoadImageFromStream

Loads an image from a stream and returns a DXSurface.

 

Remarks

The most commonly used method of this interface is IDXSurfaceFactory::CreateSurface, which creates an uninitialized DXSurface of a specified size and pixel format. The IDXSurfaceFactory::LoadImage method is also useful. This method translates an image from a common image format, such as .gif, .jpg, and .bmp, and stores the result in a new DXSurface.

This interface is exposed by the IDXTransformFactory interface. The recommended way to expose the interface is by using the IServiceProvider::QueryService method on the IDXTransformFactory with SID_DXSurfaceFactory as the service ID. You can create procedural surfaces by specifying the class identifier (CLSID) of the procedural surface for the pFormatID parameter and by using the IDXSurfaceFactory::CreateSurface method.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

 Dxtrans.h

IDL

 Dxtrans.idl

DLL

 Dxtrans.dll