IDirect3DViewport3::SetViewport

The IDirect3DViewport3::SetViewport method sets the viewport registers of the viewport. This method is provided for backward compatibility. It has been superseded by the IDirect3DViewport3::SetViewport2 method.

HRESULT SetViewport(
  LPD3DVIEWPORT lpData  
);

Parameters

lpData
Address of a D3DVIEWPORT structure that describces the new viewport properties. The method ignores the values in the dvMaxX, dvMaxY, dvMinZ, and dvMaxZ members.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value may be one of the following values:

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

Remarks

This method is unchanged from its implementation in the IDirect3DViewport2 interface.

You cannot set viewport parameters unless the viewport is associated with a rendering device (by calling the IDirect3DDevice3::AddViewport method). For details, see Preparing to Use a Viewport.

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in d3d.h.
  Import Library: Use ddraw.lib.

See Also

IDirect3DViewport3::GetViewport, IDirect3DViewport3::SetViewport2, Using Viewports, Viewports and Clipping