D3DHAL_DP2VIEWPORTINFO

  • Article

This structure is used to inform guard-band aware drivers of the view-clipping rectangle. The clipping rectangle is specified by the members dwX, dwY, dwWidth and dwHeight.

typedef struct _D3DHAL_DP2VIEWPORTINFO {
  DWORD dwX;
  DWORD dwY;
  DWORD dwWidth;
  DWORD dwHeight;
} D3DHAL_DP2VIEWPORTINFO, *LPD3DHAL_DP2VIEWPORTINFO;

Members

  • dwX, dwY
    Specify the location, in screen coordinates, of the upper-left corner of the subrectangle.
  • dwWidth, dwHeight
    Specify the width and height, respectively, of the subrectangle where the application is rendering. These members are specified in screen coordinates.

Remarks

The D3dDrawPrimitives2 callback parses a D3DHAL_DP2VIEWPORTINFO structure from the command buffer and updates the driver's viewport description when D3DHAL_DP2COMMAND is set to D3DDP2OP_VIEWPORTINFO.

One D3DHAL_DP2VIEWPORTINFO structure follows the D3DHAL_DP2COMMAND structure in the command buffer.

The driver should update the viewport portion of its internal rendering context with the location and size values specified in this structure. The driver can use this information to perform guard band clipping.

Nonguard-band drivers should ignore and skip over these instructions and continue processing the rest of the command buffer.

Requirements

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

See Also

D3dDrawPrimitives2 | D3DHAL_DP2COMMAND | D3DDP2OP_VIEWPORTINFO | D3DHAL_XXX Structures

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.