Fungsi D2D1CreateDeviceContext (d2d1_1.h)
Membuat konteks perangkat Direct2D baru yang terkait dengan permukaan DXGI.
Sintaks
HRESULT D2D1CreateDeviceContext(
[in] IDXGISurface *dxgiSurface,
[in, optional] const D2D1_CREATION_PROPERTIES *creationProperties,
[out] ID2D1DeviceContext **d2dDeviceContext
);
Parameter
[in] dxgiSurface
Permukaan DXGI yang dikaitkan dengan konteks perangkat Direct2D.
[in, optional] creationProperties
Properti yang akan diterapkan ke konteks perangkat Direct2D.
[out] d2dDeviceContext
Saat fungsi ini kembali, berisi alamat penunjuk ke konteks perangkat Direct2D.
Nilai kembali
Fungsi mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.
HRESULT | Deskripsi |
---|---|
S_OK | Tidak terjadi kesalahan. |
E_OUTOFMEMORY | Direct2D tidak dapat mengalokasikan memori yang cukup untuk menyelesaikan panggilan. |
E_INVALIDARG | Nilai yang tidak valid diteruskan ke metode . |
Keterangan
Fungsi ini juga akan membuat ID2D1Factory1 baru yang dapat diambil melalui ID2D1Resource::GetFactory.
Fungsi ini juga akan membuat ID2D1Device baru yang dapat diambil melalui ID2D1DeviceContext::GetDevice.
Perangkat DXGI akan ditentukan secara implisit melalui dxgiSurface.
Jika creationProperties tidak ditentukan, perangkat Direct2D akan mewarisi mode threading-nya dari perangkat DXGI yang disiratkan oleh dxgiSurface dan pelacakan debug tidak akan diaktifkan.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 8 dan Pembaruan Platform untuk Windows 7 [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2012 dan Platform Update untuk Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | d2d1_1.h |
DLL | D2d1.dll |