IDirect3DDevice7::SetViewport

The IDirect3DDevice7::SetViewport method sets the viewport parameters for the device.

HRESULT SetViewport(
  LPD3DVIEWPORT7 lpViewport 
); 

Parameters

lpViewport

Address of a D3DVIEWPORT7 structure that contains the viewport parameters to be set.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value is an error. The method returns DDERR_INVALIDPARAMS if the lpViewport parameter is invalid.

Remarks

This method was introduced with the IDirect3DDevice7 interface.

If the viewport parameters described by the D3DVIEWPORT7 structure describe a region that cannot exist within the render target surface, the method fails, returning DDERR_INVALIDPARAMS.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Version: Requires DirectX 7.0.
  Header: Declared in d3d.h.

See Also

IDirect3DDevice7::GetViewport