ID2D1DeviceContext ::GetTarget, méthode (d2d1_1.h)

Obtient la cible actuellement associée au contexte de l’appareil.

Syntaxe

void GetTarget(
  [out, optional] ID2D1Image **image
);

Paramètres

[out, optional] image

Type : ID2D1Image**

Lorsque cette méthode retourne, contient l’adresse d’un pointeur vers la cible actuellement associée au contexte de l’appareil.

Valeur de retour

None

Remarques

Si une cible n’est pas associée au contexte de l’appareil, la cible contient null lorsque les méthodes retournent.

Si la cible actuellement sélectionnée est une bitmap plutôt qu’une liste de commandes, l’application peut accéder aux bitmaps initiales créées à l’aide de l’une des méthodes suivantes :

• CreateHwndRenderTarget
• CreateDxgiSurfaceRenderTarget
• CreateWicBitmapRenderTarget
• CreateDCRenderTarget
• CreateCompatibleRenderTarget

Il n’est pas possible pour une application de détruire ces bitmaps. Toutes ces bitmaps peuvent être liées en tant que cibles bitmap. Toutefois, toutes ces bitmaps ne peuvent pas être utilisées comme sources bitmap pour les méthodes ID2D1RenderTarget .

CreateDxgiSurfaceRenderTarget crée une bitmap utilisable en tant que source bitmap si la surface DXGI peut être liée en tant qu’affichage de ressources du nuanceur.

CreateCompatibleRenderTarget crée toujours des bitmaps utilisables en tant que source bitmap.

ID2D1RenderTarget ::BeginDraw copie à partir du HDC vers l’image bitmap d’origine qui lui est associée. ID2D1RenderTarget ::EndDraw copie à partir de la bitmap d’origine vers le HDC.

Les objets IWICBitmap seront verrouillés dans les circonstances suivantes :

• BeginDraw a été appelé et la bitmap cible actuellement sélectionnée est une bitmap WIC.
• Une image bitmap WIC est définie comme cible d’un contexte d’appareil après l’appel de BeginDraw et avant l’appel de EndDraw.
• L’une des méthodes ID2D1Bitmap ::Copy* est appelée avec une bitmap WIC comme source ou destination.

Les objets IWICBitmap seront déverrouillés dans les circonstances suivantes :

• EndDraw est appelé et la bitmap cible actuellement sélectionnée est une bitmap WIC.
• Une image bitmap WIC est supprimée en tant que cible d’un contexte d’appareil entre les appels à BeginDraw et EndDraw.
• L’une des méthodes ID2D1Bitmap ::Copy* est appelée avec une bitmap WIC comme source ou destination.

Direct2D verrouille uniquement les bitmaps qui ne sont pas actuellement verrouillées.

L’appel de QueryInterface pour ID2D1GdiInteropRenderTarget réussit toujours. ID2D1GdiInteropRenderTarget ::GetDC retourne un contexte d’appareil correspondant à l’image bitmap cible actuellement liée. GetDC échoue si l’image bitmap cible n’a pas été créée avec l’indicateur GDI_COMPATIBLE défini.

ID2D1HwndRenderTarget ::Resize retourne DXGI_ERROR_INVALID_CALL s’il existe des références en suspens à la bitmap cible d’origine associée à la cible de rendu.

Bien que la cible puisse être une liste de commandes, il ne peut pas s’agir d’un autre type d’image. Il ne peut pas s’agir de l’image de sortie d’un effet.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 et mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	d2d1_1.h
DLL	D2d1.dll

Voir aussi

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext ::CreateBitmap

ID2D1DeviceContext ::SetTarget