ID3D11Device1::CreateDeferredContext1 metode (d3d11_1.h)

Artikel
08/22/2023

Membuat konteks yang ditangguhkan, yang dapat merekam daftar perintah.

Sintaks

HRESULT CreateDeferredContext1(
                  UINT                 ContextFlags,
  [out, optional] ID3D11DeviceContext1 **ppDeferredContext
);

Parameter

ContextFlags

Disiapkan untuk penggunaan masa mendatang. Lulus 0.

[out, optional] ppDeferredContext

Setelah menyelesaikan metode, pointer yang diteruskan ke penunjuk antarmuka ID3D11DeviceContext1 diinisialisasi.

Nilai kembali

Mengembalikan S_OK jika berhasil; jika tidak, mengembalikan salah satu hal berikut:

Mengembalikan DXGI_ERROR_DEVICE_REMOVED jika adaptor grafis telah dihapus secara fisik dari komputer atau pemutakhiran driver untuk adaptor grafis telah terjadi. Jika kesalahan ini terjadi, Anda harus menghancurkan dan membuat ulang perangkat.
Mengembalikan DXGI_ERROR_INVALID_CALL jika metode CreateDeferredContext1 tidak dapat dipanggil dari konteks saat ini. Misalnya, jika perangkat dibuat dengan nilai D3D11_CREATE_DEVICE_SINGLETHREADED , CreateDeferredContext1 mengembalikan DXGI_ERROR_INVALID_CALL.
Mengembalikan E_INVALIDARG jika parameter ContextFlags tidak valid.
Mengembalikan E_OUTOFMEMORY jika aplikasi telah kelelahan dengan memori yang tersedia.

Keterangan

Konteks yang ditangguhkan adalah konteks aman utas yang dapat Anda gunakan untuk merekam perintah grafik pada utas selain utas penyajian utama. Dengan menggunakan konteks yang ditangguhkan, Anda dapat merekam perintah grafis ke dalam daftar perintah yang dienkapulatasi oleh antarmuka ID3D11CommandList . Setelah merekam semua item adegan, Anda kemudian dapat mengirimkannya ke utas render utama untuk penyajian akhir. Dengan cara ini, Anda dapat melakukan tugas penyajian secara bersamaan di beberapa utas dan berpotensi meningkatkan performa dalam skenario CPU multi-inti.

Anda dapat membuat beberapa konteks yang ditangguhkan.

Catatan Jika Anda menggunakan nilai D3D11_CREATE_DEVICE_SINGLETHREADED untuk membuat perangkat yang diwakili oleh ID3D11Device1, metode CreateDeferredContext1 akan gagal, dan Anda tidak akan dapat membuat konteks yang ditangguhkan.

Untuk informasi selengkapnya tentang konteks yang ditangguhkan, lihat Rendering Segera dan Ditangguhkan.

Windows Phone 8: API ini didukung.

Persyaratan


Klien minimum yang didukung	Pembaruan Windows 8 dan 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	d3d11_1.h
Pustaka	D3D11.lib

Lihat juga

ID3D11Device1

ID3D11Device2::CreateDeferredContext2

ID3D11Device3::CreateDeferredContext3

ID3D11Device::CreateDeferredContext

Bagikan melalui