XFORMOBJ_iGetFloatObjXform

ULONG XFORMOBJ_iGetFloatObjXform(

IN XFORMOBJ *pxo,

OUT FLOATOBJ_XFORM *pxform

);

XFORMOBJ_iGetFloatObjXform downloads a FLOATOBJ transform to the driver.

Parameters

pxo: Points to the XFORMOBJ structure that defines the transform to be downloaded.
pxform: Points to the buffer that is to receive the FLOATOBJ_XFORM structure. This parameter can be null.

Return Value

If an error occurs, the return value is DDI_ERROR. Otherwise, the return value is a complexity hint about the transform object. The value of this transform characterization can be one of the following:

Return Value

Meaning

GX_IDENTITY

Identity matrix; no translation offset.

GX_OFFSET

Identity matrix; there is a translation offset.

GX_SCALE

Off-diagonal matrix elements are zero.

GX_GENERAL

Arbitrary 2 x 2 matrix and offset.

Comments

If pxform is not null, XFORMOBJ_iGetFloatObjXform loads a FLOATOBJ_XFORM into it. This function allows graphics drivers to emulate floating point arithmetic. Windows NT does not support kernel-mode floating point operations on some systems.

Return Value	Meaning
GX_IDENTITY	Identity matrix; no translation offset.
GX_OFFSET	Identity matrix; there is a translation offset.
GX_SCALE	Off-diagonal matrix elements are zero.
GX_GENERAL	Arbitrary 2 x 2 matrix and offset.