ID3D11DeviceContext::Metode GetData (d3d11.h)

Artikel
02/26/2024

Dapatkan data dari unit pemrosesan grafis (GPU) secara asinkron.

Sintaks

HRESULT GetData(
  [in]            ID3D11Asynchronous *pAsync,
  [out, optional] void               *pData,
  [in]            UINT               DataSize,
  [in]            UINT               GetDataFlags
);

Parameter

[in] pAsync

Jenis: ID3D11Asynchronous*

Penunjuk ke antarmuka ID3D11Asynchronous untuk objek tempat GetData mengambil data.

[out, optional] pData

Jenis: batal*

Alamat memori yang akan menerima data. Jika NULL, GetData hanya akan digunakan untuk memeriksa status. Jenis output data tergantung pada jenis antarmuka asinkron.

[in] DataSize

Jenis: UINT

Ukuran data yang akan diambil atau 0. Harus 0 ketika pData adalah NULL.

[in] GetDataFlags

Jenis: UINT

Bendera opsional. Dapat berupa 0 atau kombinasi bendera apa pun yang dijumlahkan oleh D3D11_ASYNC_GETDATA_FLAG.

Mengembalikan nilai

Jenis: HRESULT

Metode ini mengembalikan salah satu Kode Pengembalian Direct3D 11. Nilai pengembalian S_OK menunjukkan bahwa data di pData tersedia untuk diakses oleh aplikasi panggilan. Nilai pengembalian S_FALSE menunjukkan bahwa data belum tersedia. Jika data belum tersedia, aplikasi harus memanggil GetData hingga data tersedia.

Keterangan

Kueri dalam konteks yang ditangguhkan terbatas pada gambar berpredikat. Artinya, Anda tidak dapat memanggil ID3D11DeviceContext::GetData pada konteks yang ditangguhkan untuk mendapatkan data tentang kueri; Anda hanya bisa memanggil GetData pada konteks langsung untuk mendapatkan data tentang kueri. Untuk gambar berpredikat, hasil kueri jenis predikasi digunakan oleh GPU dan tidak dikembalikan ke aplikasi. Untuk informasi selengkapnya tentang predikasi dan gambar berpredikat, lihat D3D11DeviceContext::SetPredication.

GetData mengambil data yang dikumpulkan runtime antara panggilan ke ID3D11DeviceContext::Begin dan ID3D11DeviceContext::End. Kueri tertentu hanya memerlukan panggilan ke ID3D11DeviceContext::End dalam hal ini data yang dikembalikan oleh GetData akurat hingga panggilan terakhir ke ID3D11DeviceContext::End. Untuk informasi tentang kueri yang hanya memerlukan panggilan ke ID3D11DeviceContext::End dan tentang jenis data yang diambil GetData untuk setiap kueri, lihat D3D11_QUERY.

Jika DataSize adalah 0, GetData hanya digunakan untuk memeriksa status.

Aplikasi mengumpulkan data penghitung dengan memanggil ID3D11DeviceContext::Begin, mengeluarkan beberapa perintah grafis, memanggil ID3D11DeviceContext::End, lalu memanggil ID3D11DeviceContext::GetData untuk mendapatkan data tentang apa yang terjadi di antara panggilan Mulai dan Akhir . Untuk informasi tentang jenis penghitung kinerja, lihat D3D11_COUNTER.

Persyaratan

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

Lihat juga

ID3D11DeviceContext

Bagikan melalui