METODE ID3D11Device::CreateDeferredContext (d3d11.h)

Artikel
08/22/2023

Membuat konteks yang ditangguhkan, yang dapat merekam daftar perintah.

Sintaks

HRESULT CreateDeferredContext(
                  UINT                ContextFlags,
  [out, optional] ID3D11DeviceContext **ppDeferredContext
);

Parameter

ContextFlags

Jenis: UINT

Disiapkan untuk penggunaan masa mendatang. Lewati 0.

[out, optional] ppDeferredContext

Jenis: ID3D11DeviceContext**

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

Nilai kembali

Jenis: HRESULT

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

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

Keterangan

Konteks yang ditangguhkan adalah konteks aman utas yang dapat Anda gunakan untuk merekam perintah grafis pada utas selain utas penyajian utama. Dengan menggunakan konteks yang ditangguhkan, Anda dapat merekam perintah grafis ke dalam daftar perintah yang dienkapsulasi oleh antarmuka ID3D11CommandList . Setelah semua item adegan direkam, 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 ID3D11Device, metode CreateDeferredContext 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.