IDXBaseObject interface

  • Article

The IDXBaseObject interface manages the generation ID of an object.

Members

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

  • Methods

Methods

The IDXBaseObject interface has these methods.

Method Description
GetGenerationId

Retrieves the current generation ID for the object.
GetObjectSize

Retrieves the size, in bytes, of the data object (for example, a surface or buffer).
IncrementGenerationId

Manually increments the object generation ID.

 

Remarks

Every time an operation changes the state of an object, the generation ID is incremented. The following are examples of operations that change the generation IDs of objects.

  • Locking a surface with a read/write pointer.
  • Setting up a transform.
  • Changing the properties of a transform.
  • Changing the properties of a procedural surface.

When calling the IDXBaseObject::GetGenerationId method for a transform, the transform examines the generation IDs of all inputs. If they have changed, the transform's generation ID changes. If the ID has not changed since the last time a transform was executed or a surface was used, this indicates that the data has not changed. It is then possible to skip execution of a transform Setup or the copying of a surface.

The IDXBaseObject interface is exposed on DXSurface objects and DXTransform objects.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

 Dxtrans.h

IDL

 Dxtrans.idl

DLL

 Dxtrans.dll