Freigeben über


D2D1CreateDevice-Funktion (d2d1_1.h)

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
);

Die 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ückgegeben wird, enthält sie die Adresse eines Zeigers auf ein Direct2D-Gerät.

Rückgabewert

Die Funktion gibt ein HRESULT zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

HRESULT Description
S_OK Es ist kein Fehler aufgetreten.
E_OUTOFMEMORY Direct2D konnte nicht genügend Arbeitsspeicher zuweisen, um den Anruf abzuschließen.
E_INVALIDARG An die Methode wurde ein ungültiger Wert übergeben.

Bemerkungen

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

Wenn die Erstellungseigenschaften nicht angegeben sind, erbt d2dDevice den Threadingmodus von dxgiDevice , und die Debugablaufverfolgung wird nicht aktiviert.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Fenster
Header d2d1_1.h
Library d2d1.lib
DLL D2d1.dll

Siehe auch

D2D1CreateFactory

D2D1_CREATION_PROPERTIES

ID2D1Device

ID2D1Factory

ID2D1Resource::GetFactory