Share via

D3DHAL_DP2TEXTURESTAGESTATE

  • Article

One or more of these structures are parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_TEXTURESTAGESTATE, and are used to set the appropriate texture stage state.

typedef struct _D3DHAL_DP2TEXTURESTAGESTATE {
  DWORD dwStage;
  D3DTEXTURESTAGESTATETYPE TSState;
  DWORD dwValue;
} D3DHAL_DP2TEXTURESTAGESTATE;

Members

  • dwStage
    Identifies the texture stage where to update the texture state. This member can be an integer in the range zero through 7, with the highest numbered texture being closest to the frame buffer.
  • TSState
    Specifies a D3DTEXTURESTAGESTATETYPE enumerated value, described in the DirectX SDK documentation, that specifies the texture state to be updated.
  • dwValue
    Specifies the value that the driver should update the texture state identified by TSState to.

Remarks

D3dDrawPrimitives2 should process wStateCount D3DHAL_DP2TEXTURESTAGESTATE structures from the command buffer. The value of wStateCount is specified in the D3DHAL_DP2COMMAND structure.

For each D3DHAL_DP2TEXTURESTAGESTATE structure, D3dDrawPrimitives2 should update the driver's internal texture state associated with the texture at dwStage to reflect the new value based on TSState.

Drivers that do not support multitexturing should implement support for texture stage zero only.

The following figure shows a portion of a sample command buffer containing a D3DDP2OP_TEXTURESTAGESTATE command and three D3DHAL_DP2TEXTURESTAGESTATE structures. The driver should update stages zero and three of its private texture stage state accordingly.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3dhal.h.

See Also

D3dDrawPrimitives2 | D3DHAL_DP2COMMAND | D3DDP2OP_TEXTURESTAGESTATE | D3DTEXTURESTAGESTATETYPE | D3DDP2OP_TEXTURESTAGESTATE | D3DHAL_XXX Structures

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.