Fungsi D2D1CreateDeviceContext (d2d1_1.h)

Artikel
03/04/2024

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