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