D2D1CreateDevice-Funktion (d2d1_1.h)

  • Artikel

Erstellt ein neues Direct2D-Gerät, das dem bereitgestellten DXGI-Gerät zugeordnet ist.

Syntax

HRESULT D2D1CreateDevice(
  [in]           IDXGIDevice                    *dxgiDevice,
  [in, optional] const D2D1_CREATION_PROPERTIES *creationProperties,
  [out]          ID2D1Device                    **d2dDevice
);

Parameter

[in] dxgiDevice

Das DXGI-Gerät, dem das Direct2D-Gerät zugeordnet ist.

[in, optional] creationProperties

Die Eigenschaften, die auf das Direct2D-Gerät angewendet werden sollen.

[out] d2dDevice

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

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.

Wenn die Erstellungseigenschaften nicht angegeben werden, erbt d2dDevice seinen Threadingmodus von dxgiDevice , 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

Weitere Informationen

D2D1CreateFactory

D2D1_CREATION_PROPERTIES

ID2D1Device

ID2D1Factory

ID2D1Resource::GetFactory