D2D1CreateDeviceContext-Funktion (d2d1_1.h)
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 |