PFND3DDDI_SETTEXTURESTAGESTATE callback function

The SetTextureStageState function updates the state of a texture at a particular stage in a multiple-texture group.

Syntax

PFND3DDDI_SETTEXTURESTAGESTATE Pfnd3dddiSettexturestagestate;

HRESULT Pfnd3dddiSettexturestagestate(
  HANDLE hDevice,
  const D3DDDIARG_TEXTURESTAGESTATE *Arg2
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

Arg2

pData [in]

A pointer to a D3DDDIARG_TEXTURESTAGESTATE structure that describes how to update the texture.

Return Value

SetTextureStageState returns S_OK or an appropriate error result if the texture is not successfully updated.

Remarks

The user-mode display driver is not required to store colorkey values in its private allocation structure because the Microsoft Direct3D runtime always passes the appropriate colorkeying information in calls to the driver's SetTextureStageState function. For example, the runtime passes the following colorkey information in the indicated members of the D3DDDIARG_TEXTURESTAGESTATE structure that is pointed to by pData to perform the indicated colorkey operation:

  • D3DTSS_TEXTURECOLORKEYVAL in the State member and a colorkey value in the Value member to update the current texture's colorkey
  • D3DTSS_DISABLETEXTURECOLORKEY in the State member and TRUE in the Value member to disable the current texture's colorkey

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_TEXTURESTAGESTATE

D3DDDI_DEVICEFUNCS