IDirect3DDevice8::SetViewport

  • Article

This method sets the viewport parameters for the device.

HRESULT SetViewport(
  CONST D3DVIEWPORT8* pViewport
);

Parameters

  • pViewport
    [in] Pointer to a D3DVIEWPORT8 structure, specifying the viewport parameters to set.

Return Values

If the method succeeds, the return value is D3D_OK.

D3DERR_INVALIDCALL if the pViewport parameter is invalid.

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

Remarks

Any call to SetViewPort between a pair of calls to IDirect3DDevice8::BeginScene and IDirect3DDevice8::EndScene must be made before any geometry is drawn.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8.h.
Link Library: D3d8.lib.

See Also

IDirect3DDevice8::BeginScene | IDirect3DDevice8::EndScene | IDirect3DDevice8::GetViewport | D3DVIEWPORT8 | IDirect3DDevice8

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.