Partager via

MÉTHODE ID2D1Factory ::CreateHwndRenderTarget(constD2D1_RENDER_TARGET_PROPERTIES&,constD2D1_HWND_RENDER_TARGET_PROPERTIES&,ID2D1HwndRenderTarget**) (d2d1.h)

  • Article

Crée un ID2D1HwndRenderTarget, une cible de rendu qui s’affiche dans une fenêtre.

Lorsque vous créez une cible de rendu et que l’accélération matérielle est disponible, vous allouez des ressources sur le GPU de l’ordinateur. En créant une cible de rendu une seule fois et en la conservant aussi longtemps que possible, vous obtenez des avantages en matière de performances. Votre application doit créer des cibles de rendu une seule fois et les conserver pendant toute la durée de vie de l’application ou jusqu’à ce que l’erreur D2DERR_RECREATE_TARGET soit reçue. Lorsque vous recevez cette erreur, vous devez recréer la cible de rendu (et toutes les ressources qu’elle a créées).

Syntaxe

HRESULT CreateHwndRenderTarget(
  const D2D1_RENDER_TARGET_PROPERTIES &      renderTargetProperties,
  const D2D1_HWND_RENDER_TARGET_PROPERTIES & hwndRenderTargetProperties,
  ID2D1HwndRenderTarget                      **hwndRenderTarget
);

Paramètres

renderTargetProperties

Type : [in] const D2D1_RENDER_TARGET_PROPERTIES &

Le mode de rendu, le format des pixels, les options de communication à distance, les informations PPP et la prise en charge minimale de DirectX requise pour le rendu matériel. Pour plus d’informations sur les formats de pixels pris en charge, consultez Formats de pixels pris en charge et Modes alpha.

hwndRenderTargetProperties

Type : [in] const D2D1_HWND_RENDER_TARGET_PROPERTIES &

Handle de fenêtre, taille initiale (en pixels) et options de présentation.

hwndRenderTarget

Type : [out] ID2D1HwndRenderTarget**

Lorsque cette méthode est retournée, contient l’adresse du pointeur vers l’objet ID2D1HwndRenderTarget créé par cette méthode.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT .

Remarques

Lorsque vous créez une cible de rendu et que l’accélération matérielle est disponible, vous allouez des ressources sur le GPU de l’ordinateur. En créant une cible de rendu une seule fois et en la conservant aussi longtemps que possible, vous obtenez des avantages en matière de performances. Votre application doit créer des cibles de rendu une seule fois et les conserver pendant toute la durée de vie de l’application ou jusqu’à ce que l’erreur D2DERR_RECREATE_TARGET soit reçue. Lorsque vous recevez cette erreur, vous devez recréer la cible de rendu (et toutes les ressources qu’elle a créées).

Exemples

L’exemple suivant crée un ID2D1HwndRenderTarget.

RECT rc;
GetClientRect(m_hwnd, &rc);

D2D1_SIZE_U size = D2D1::SizeU(
    rc.right - rc.left,
    rc.bottom - rc.top
    );

// Create a Direct2D render target.
hr = m_pD2DFactory->CreateHwndRenderTarget(
    D2D1::RenderTargetProperties(),
    D2D1::HwndRenderTargetProperties(m_hwnd, size),
    &m_pRenderTarget
    );

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête d2d1.h
Bibliothèque D2d1.lib
DLL D2d1.dll

Voir aussi

ID2D1Factory