Funzione D2D1CreateDeviceContext (d2d1_1.h)
Crea un nuovo contesto di dispositivo Direct2D associato a una superficie DXGI.
Sintassi
HRESULT D2D1CreateDeviceContext(
[in] IDXGISurface *dxgiSurface,
[in, optional] const D2D1_CREATION_PROPERTIES *creationProperties,
[out] ID2D1DeviceContext **d2dDeviceContext
);
Parametri
[in] dxgiSurface
La superficie DXGI del contesto del dispositivo Direct2D è associata.
[in, optional] creationProperties
Proprietà da applicare al contesto del dispositivo Direct2D.
[out] d2dDeviceContext
Quando questa funzione restituisce, contiene l'indirizzo di un puntatore a un contesto di dispositivo Direct2D.
Valore restituito
La funzione restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
| HRESULT | Descrizione |
|---|---|
| S_OK | Non si sono verificati errori. |
| E_OUTOFMEMORY | Direct2D non è riuscito a allocare memoria sufficiente per completare la chiamata. |
| E_INVALIDARG | Un valore non valido è stato passato al metodo. |
Commenti
Questa funzione creerà anche un nuovo ID2D1Factory1 che può essere recuperato tramite ID2D1Resource::GetFactory.
Questa funzione creerà anche un nuovo ID2D1Device che può essere recuperato tramite ID2D1DeviceContext::GetDevice.
Il dispositivo DXGI verrà specificato in modo implicito tramite dxgiSurface.
Se le proprietà di creazione non sono specificate, il dispositivo Direct2D erediterà la modalità di threading dal dispositivo DXGI implicito da dxgiSurface e la traccia di debug non verrà abilitata.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 e Aggiornamento della piattaforma per Windows 7 [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2012 e Aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | d2d1_1.h |
| DLL | D2d1.dll |