IDirect3DDevice9::SetViewport 方法 (d3d9.h)

设置设备的视区参数。

语法

HRESULT SetViewport(
  [in] const D3DVIEWPORT9 *pViewport
);

参数

[in] pViewport

类型: const D3DVIEWPORT9*

指向 D3DVIEWPORT9 结构的指针,指定要设置的视区参数。

返回值

类型: HRESULT

如果该方法成功,则返回值D3D_OK。 如果方法失败,它将返回D3DERR_INVALIDCALL。 如果 pViewport 无效,或者 pViewport 描述呈现目标图面中不能存在的区域,则会发生此情况。

注解

Direct3D 为视区设置以下默认值。


D3DVIEWPORT9 vp;
vp.X      = 0;
vp.Y      = 0;
vp.Width  = RenderTarget.Width;
vp.Height = RenderTarget.Height;
vp.MinZ   = 0.0f;
vp.MaxZ   = 1.0f;

IDirect3DDevice9::SetViewport 可用于在屏幕的一部分上进行绘制。 请确保在绘制任何几何图形之前调用它,以便视区设置生效。

若要在场景中绘制多个视图,请重复 IDirect3DDevice9::SetViewport 并为每个视图绘制几何图形序列。

要求

要求
目标平台 Windows
标头 d3d9.h (包括 D3D9.h)
Library D3D9.lib

另请参阅

IDirect3DDevice9

IDirect3DDevice9::GetViewport