Package com.ms.com.directX

Previous

Microsoft Packages

Index

Next

Interface IUserVisualCallback

public interface IUserVisualCallback extends IUnknown {
  public void callbackUserVisual(d3drmUserVisual uv, IUnknown Arg, int[] r, 
            d3drmDevice d, d3drmViewport v);
}

Use with CreateUserVisual and Init to set the callback function to be called to render an application-defined visual.

Methods

callbackUserVisual

public void callbackUserVisual(d3drmUserVisual uv, IUnknown Arg, int[] r, 
            d3drmDevice d, d3drmViewport v);

Alerts an application that supplies user-visual objects that it should execute the execute buffer. This function is application-defined.

Return Value:

No return value.

Parameter	Description
uv	The d3drmUserVisual object.
Arg	Application-defined data passed to this callback function.
r	Array variable that contains a value of user visual reason type: D3DRMUSERVISUAL_CANSEE The application should set this parameter to TRUE if the user-visual object is visible in the viewport. In this case, the application uses the device specified in the v parameter. D3DRMUSERVISUAL_RENDER The application should render the user-visual element. In this case, the application uses the device specified in the d parameter.
d	A d3drmDevice object used to render the d3drmUserVisual object.
v	A d3drmViewport object used to determine whether the d3drmUserVisual object is visible.

Remarks:

When determining the order in which to call callback functions, the system searches the objects highest in the hierarchy first, and then calls their callback functions in the order in which they were created.