IDXSurfaceFactory interface
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 |