Partager via


Méthode IDirect3DDevice9 ::SetViewport (d3d9.h)

Définit les paramètres de fenêtre d’affichage de l’appareil.

Syntaxe

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

Paramètres

[in] pViewport

Type : const D3DVIEWPORT9*

Pointeur vers une structure D3DVIEWPORT9 , spécifiant les paramètres de fenêtre d’affichage à définir.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, elle retourne D3DERR_INVALIDCALL. Cela se produit si pViewport n’est pas valide ou si pViewport décrit une région qui ne peut pas exister dans la surface cible de rendu.

Remarques

Direct3D définit les valeurs par défaut suivantes pour la fenêtre d’affichage.


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 peut être utilisé pour dessiner sur une partie de l’écran. Veillez à l’appeler avant qu’une géométrie ne soit dessinée afin que les paramètres de la fenêtre d’affichage prennent effet.

Pour dessiner plusieurs vues dans une scène, répétez IDirect3DDevice9 ::SetViewport et dessinez la séquence géométrique pour chaque vue.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d3d9.h (inclure D3D9.h)
Bibliothèque D3D9.lib

Voir aussi

IDirect3DDevice9

IDirect3DDevice9 ::GetViewport