D2D1CreateDeviceContext-Funktion (d2d1_1.h)

Artikel
03/01/2024

Erstellt einen neuen Direct2D-Gerätekontext, der einer DXGI-Oberfläche zugeordnet ist.

Syntax

HRESULT D2D1CreateDeviceContext(
  [in]           IDXGISurface                   *dxgiSurface,
  [in, optional] const D2D1_CREATION_PROPERTIES *creationProperties,
  [out]          ID2D1DeviceContext             **d2dDeviceContext
);

Parameter

[in] dxgiSurface

Die DXGI-Oberfläche, der der Direct2D-Gerätekontext zugeordnet ist.

[in, optional] creationProperties

Die Eigenschaften, die auf den Direct2D-Gerätekontext angewendet werden sollen.

[out] d2dDeviceContext

Wenn diese Funktion zurückgibt, enthält die Adresse eines Zeigers auf einen Direct2D-Gerätekontext.

Rückgabewert

Die Funktion gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

HRESULT	BESCHREIBUNG
S_OK	Kein Fehler ist aufgetreten.
E_OUTOFMEMORY	Direct2D konnte nicht genügend Arbeitsspeicher zuweisen, um den Aufruf abzuschließen.
E_INVALIDARG	Ein ungültiger Wert wurde an die -Methode übergeben.

Hinweise

Diese Funktion erstellt auch eine neue ID2D1Factory1 , die über ID2D1Resource::GetFactory abgerufen werden kann.

Diese Funktion erstellt auch ein neues ID2D1Device , das über ID2D1DeviceContext::GetDevice abgerufen werden kann.

Das DXGI-Gerät wird implizit über dxgiSurface angegeben.

Wenn creationProperties nicht angegeben werden, erbt das Direct2D-Gerät seinen Threadingmodus vom DXGI-Gerät, das von dxgiSurface impliziert wird, und die Debugablaufverfolgung wird nicht aktiviert.

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