Export (0) Print
Expand All

IDXTransformFactory Interface

This topic documents a feature of Visual Filters and Transitions, which is deprecated as of Windows Internet Explorer 9 and obsolete as of Internet Explorer 10.

The IDXTransformFactory interface creates and initializes a transform. It is created by calling the CoCreateInstance method and specifying CLSID_DXTransformFactory as the class identifier (CLSID) and IID_IDXTransformFactory as the interface ID.

IDXTransformFactory Members

CreateTransform Creates and initializes a transform.
InitializeTransform Initializes a transform that has been created by the caller.
SetService Adds a service provider to the Transform Factory.


You can use the IDXTransformFactory::CreateTransform method to create and initialize a transform in one step. Alternatively, you can use the Component Object Model (COM)  CoCreateInstance method to create the transform and initialize it by using the IDXTransformFactory::InitializeTransform method. After the transform is created and initialized, it can be executed by using IDXTransform::Setup and then IDXTransform::Execute.

IDXTransformFactory also provides support services to transforms through the IServiceProvider interface. An important service that this interface provides is access to the IDXSurfaceFactory interface, which is exposed when the DXTransformFactory is created. A pointer to the DXSurfaceFactory can be obtained by calling the IServiceProvider::QueryService method on IDXTransformFactory with SID_DXSurfaceFactory as the service ID. The pointer to the DXSurfaceFactory can then be used to create a DXSurface. Furthermore, the task management service is created and added to the factory upon first query by default. You can add service providers through the IDXTransformFactory::SetService method. These services can be requested later, potentially by different transforms. A transform typically tries to obtain a service from the factory before it creates and adds a new one. This avoids duplication of identical servers across the simultaneously active transforms.

For more information on how to use this interface in your application, see About Transforms and DXSurfaces overview article.

This interface inherits from the standard COM interface IServiceProvider.

Interface Information

Stock Implementation dxtrans.dll
Custom Implementation No
Inherits from IServiceProvider
Header and IDL files dxtrans.h, dxtrans.idl
Minimum availability Internet Explorer 4.0
Minimum operating systems Windows 95, Windows NT 4.0

Community Additions

© 2014 Microsoft