METODE ID3D11DeviceContext::ExecuteCommandList (d3d11.h)

Artikel
08/22/2023

Mengantrekan perintah dari daftar perintah ke perangkat.

Sintaks

void ExecuteCommandList(
  [in] ID3D11CommandList *pCommandList,
       BOOL              RestoreContextState
);

Parameter

[in] pCommandList

Jenis: ID3D11CommandList*

Penunjuk ke antarmuka ID3D11CommandList yang merangkum daftar perintah.

RestoreContextState

Jenis: BOOL

Bendera Boolean yang menentukan apakah status konteks target disimpan sebelum dan dipulihkan setelah eksekusi daftar perintah. Gunakan TRUE untuk menunjukkan bahwa runtime perlu menyimpan dan memulihkan status. Gunakan FALSE untuk menunjukkan bahwa tidak ada status yang akan disimpan atau dipulihkan, yang menyebabkan konteks target kembali ke status defaultnya setelah daftar perintah dijalankan. Aplikasi biasanya harus menggunakan FALSE kecuali mereka akan memulihkan status menjadi hampir setara dengan status yang akan dipulihkan oleh runtime jika TRUE diteruskan. Ketika aplikasi menggunakan FALSE, aplikasi dapat menghindari transisi status yang tidak perlu dan tidak efisien.

Nilai kembali

Tidak ada

Keterangan

Gunakan metode ini untuk memutar kembali daftar perintah yang direkam oleh konteks yang ditangguhkan pada utas apa pun.

Panggilan ke ExecuteCommandList dari daftar perintah dari konteks yang ditangguhkan ke konteks langsung diperlukan agar perintah yang direkam dijalankan pada unit pemrosesan grafis (GPU). Panggilan ke ExecuteCommandList dari daftar perintah dari konteks yang ditangguhkan ke konteks lain yang ditangguhkan dapat digunakan untuk menggabungkan daftar yang direkam. Tetapi untuk menjalankan perintah dari daftar perintah yang ditangguhkan yang digabungkan pada GPU, Anda perlu menjalankannya pada konteks langsung.

Metode ini melakukan beberapa validasi runtime yang terkait dengan kueri. Kueri yang dimulai dalam konteks perangkat tidak dapat dimanipulasi secara tidak langsung dengan menjalankan daftar perintah (yaitu, Mulai atau Akhir dipanggil terhadap kueri yang sama oleh konteks yang ditangguhkan yang menghasilkan daftar perintah). Jika kondisi seperti itu terjadi, metode ExecuteCommandList tidak menjalankan daftar perintah. Namun, status konteks perangkat masih dipertahankan, seperti yang diharapkan (ID3D11DeviceContext::ClearState dilakukan, kecuali aplikasi menunjukkan untuk mempertahankan status konteks perangkat).

Windows Phone 8: API ini didukung.

Persyaratan

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

Lihat juga

ID3D11DeviceContext

Share via