ID2D1DeviceContext::GetTarget-Methode (d2d1_1.h)

  • Artikel

Ruft das Ziel ab, das derzeit dem Gerätekontext zugeordnet ist.

Syntax

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

Parameter

[out, optional] image

Typ: ID2D1Image**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf das Ziel, das derzeit dem Gerätekontext zugeordnet ist.

Rückgabewert

Keine

Bemerkungen

Wenn dem Gerätekontext kein Ziel zugeordnet ist, enthält das ZielNULL , wenn die Methoden zurückgegeben werden.

Wenn das derzeit ausgewählte Ziel eine Bitmap und keine Befehlsliste ist, kann die Anwendung Zugriff auf die anfänglichen Bitmaps erhalten, die mit einer der folgenden Methoden erstellt wurden:

Es ist nicht möglich, dass eine Anwendung diese Bitmaps zerstört. Alle diese Bitmaps können als Bitmapziele gebunden werden. Allerdings können nicht alle diese Bitmaps als Bitmapquellen für ID2D1RenderTarget-Methoden verwendet werden.

CreateDxgiSurfaceRenderTarget erstellt eine Bitmap, die als Bitmapquelle verwendet werden kann, wenn die DXGI-Oberfläche als Shaderressourcenansicht gebunden werden kann.

CreateCompatibleRenderTarget erstellt immer Bitmaps, die als Bitmapquelle verwendet werden können.

ID2D1RenderTarget::BeginDraw kopiert das HDC in die ursprüngliche Bitmap, die ihr zugeordnet ist. ID2D1RenderTarget::EndDraw kopiert die ursprüngliche Bitmap in den HDC.

IWICBitmap-Objekte werden unter folgenden Umständen gesperrt:

  • BeginDraw wurde aufgerufen, und die derzeit ausgewählte Zielbitbitbit ist eine WIC-Bitmap.
  • Eine WIC-Bitmap wird als Ziel eines Gerätekontexts festgelegt, nachdem BeginDraw aufgerufen wurde und bevor EndDraw aufgerufen wurde.
  • Jede der ID2D1Bitmap::Copy*-Methoden wird mit einer WIC-Bitmap als Quelle oder Ziel aufgerufen.
IWICBitmap-Objekte werden unter den folgenden Umständen entsperrt:
  • EndDraw wird aufgerufen, und die derzeit ausgewählte Zielbitbitbit ist eine WIC-Bitmap.
  • Eine WIC-Bitmap wird als Ziel eines Gerätekontexts zwischen den Aufrufen von BeginDraw und EndDraw entfernt.
  • Jede der ID2D1Bitmap::Copy*-Methoden wird mit einer WIC-Bitmap als Quelle oder Ziel aufgerufen.
Direct2D sperrt nur Bitmaps, die derzeit nicht gesperrt sind.

Das Aufrufen von QueryInterface für ID2D1GdiInteropRenderTarget ist immer erfolgreich. ID2D1GdiInteropRenderTarget::GetDC gibt einen Gerätekontext zurück, der der aktuell gebundenen Zielbitbitbit entspricht. GetDC schlägt fehl, wenn die Zielbit nicht mit festgelegtem GDI_COMPATIBLE-Flag erstellt wurde.

ID2D1HwndRenderTarget::Resize gibt DXGI_ERROR_INVALID_CALL zurück, wenn ausstehende Verweise auf die ursprüngliche Zielbit dem Renderziel zugeordnet sind.

Obwohl das Ziel eine Befehlsliste sein kann, darf es sich nicht um einen anderen Imagetyp handeln. Es kann nicht das Ausgabebild eines Effekts sein.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile d2d1_1.h
DLL D2d1.dll

Weitere Informationen

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::SetTarget