DXUTSetCallbackFrameMove

Sets the frame update callback function.

VOID DXUTSetCallbackFrameMove(
  LPDXUTCALLBACKFRAMEMOVE pCallbackFrameMove,
  void* pUserContext
);

Parameters

pCallbackFrameMove

[in] Pointer to a LPDXUTCALLBACKFRAMEMOVE callback function. If the callback function is supplied, it will be called at the beginning of every frame to facilitate updates to the scene. If NULL, DXUT will not notify the application about new frames.

pUserContext

[in] Pointer to a user-defined value which is passed to the callback function. Typically used by an application to pass a pointer to a data structure that provides context information for the callback function. The default value is NULL

Return Values

No return value.

Remarks

The LPDXUTCALLBACKFRAMEMOVE callback function is the appropriate location for the application to handle updates to the scene. However, LPDXUTCALLBACKFRAMEMOVE is not intended to contain actual rendering calls, which should instead be placed in the LPDXUTCALLBACKFRAMERENDER callback function.

The LPDXUTCALLBACKFRAMEMOVE callback function will be called once per frame, while the LPDXUTCALLBACKFRAMERENDER callback function will be called when the scene needs to be rendered, which might be more than once per frame.

Requirements

Header: Declared in Dxut.h.

See Also

LPDXUTCALLBACKFRAMEMOVE, LPDXUTCALLBACKFRAMERENDER, DXUTSetCallbackFrameRender