METODE ID3D11DeviceContext::FinishCommandList (d3d11.h)

Artikel
08/22/2023

Buat daftar perintah dan rekam perintah grafik ke dalamnya.

Sintaks

HRESULT FinishCommandList(
                  BOOL              RestoreDeferredContextState,
  [out, optional] ID3D11CommandList **ppCommandList
);

Parameter

RestoreDeferredContextState

Jenis: BOOL

Bendera Boolean yang menentukan apakah runtime menyimpan status konteks yang ditangguhkan sebelum menjalankan FinishCommandList dan memulihkannya setelahnya. Gunakan TRUE untuk menunjukkan bahwa runtime perlu menyimpan dan memulihkan status. Gunakan FALSE untuk menunjukkan bahwa runtime tidak akan menyimpan atau memulihkan status apa pun. Dalam hal ini, konteks yang ditangguhkan akan kembali ke status defaultnya setelah panggilan ke FinishCommandList selesai. Untuk informasi tentang status default, lihat ID3D11DeviceContext::ClearState. Biasanya, gunakan FALSE kecuali Anda memulihkan status menjadi hampir setara dengan status yang akan dipulihkan oleh runtime jika Anda melewati TRUE. Saat Anda menggunakan FALSE, Anda dapat menghindari transisi status yang tidak perlu dan tidak efisien.

Catatan Parameter ini tidak memengaruhi daftar perintah yang dikembalikan panggilan saat ini ke FinishCommandList . Namun, parameter ini memengaruhi daftar perintah panggilan berikutnya ke FinishCommandList pada konteks yang ditangguhkan yang sama.

[out, optional] ppCommandList

Jenis: ID3D11CommandList**

Setelah menyelesaikan metode, pointer yang diteruskan ke penunjuk antarmuka ID3D11CommandList diinisialisasi dengan informasi daftar perintah yang direkam. Objek ID3D11CommandList yang dihasilkan tidak dapat diubah dan hanya dapat digunakan dengan ID3D11DeviceContext::ExecuteCommandList.

Mengembalikan nilai

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 FinishCommandList tidak dapat dipanggil dari konteks saat ini. Lihat komentar.
Mengembalikan E_OUTOFMEMORY jika aplikasi telah kelelahan memori yang tersedia.

Keterangan

Buat daftar perintah dari konteks yang ditangguhkan dan rekam perintah ke dalamnya dengan memanggil FinishCommandList. Putar kembali daftar perintah dengan konteks langsung dengan memanggil ID3D11DeviceContext::ExecuteCommandList.

Status konteks langsung dibersihkan sebelum dan sesudah daftar perintah dijalankan. Daftar perintah tidak memiliki konsep pewarisan. Setiap panggilan ke FinishCommandList hanya akan merekam status yang ditetapkan sejak panggilan sebelumnya ke FinishCommandList.

Misalnya, status konteks perangkat adalah status render atau status alurnya. Untuk mengambil status konteks perangkat, aplikasi dapat memanggil ID3D11DeviceContext::GetData atau ID3D11DeviceContext::GetPredication.

Untuk informasi selengkapnya tentang cara menggunakan FinishCommandList, lihat Cara: Merekam Daftar Perintah.

Windows Phone 8: API ini didukung.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	d3d11.h
Pustaka	D3d11.lib

Lihat juga

ID3D11DeviceContext

Share via