PFND3DDDI_SETRENDERSTATE callback function

The SetRenderState function updates a render state.

Syntax

PFND3DDDI_SETRENDERSTATE Pfnd3dddiSetrenderstate;

HRESULT Pfnd3dddiSetrenderstate(
  HANDLE hDevice,
  const D3DDDIARG_RENDERSTATE *Arg2
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

Arg2

pData [in]

A pointer to a D3DDDIARG_RENDERSTATE structure that describes how to update the render state.

Return Value

SetRenderState returns S_OK or an appropriate error result if the render state is not successfully updated.

Remarks

The Microsoft Direct3D runtime maps BeginScene and EndScene calls from applications to the user-mode display driver's SetRenderState function. When the runtime receives a BeginScene call, it sets the State member of the D3DDDIARG_RENDERSTATE structure that is pointed to by pData to D3DRENDERSTATE_SCENECAPTURE and the Value member of D3DDDIARG_RENDERSTATE to TRUE and then calls SetRenderState. When the runtime receives an EndScene call, it sets the State member to D3DRENDERSTATE_SCENECAPTURE and the Value member to FALSE and then calls SetRenderState. In between these calls to SetRenderState, the driver captures geometric data within a frame.

Requirements

   
Minimum supported client Available in Windows Vista and later versions of the Windows operating systems.
Target Platform Desktop
Header d3dumddi.h (include D3dumddi.h)

See Also

D3DDDIARG_RENDERSTATE

D3DDDI_DEVICEFUNCS