struktur DXGKARG_FORMATHISTORYBUFFER (d3dkmddi.h)
Berisi info untuk driver miniport tampilan untuk memformat buffer riwayat.
Sintaks
typedef struct _DXGKARG_FORMATHISTORYBUFFER {
DXGK_HISTORY_BUFFER *pHistoryBuffer;
UINT32 HistoryBufferSize;
PVOID pFormattedBuffer;
UINT32 FormattedBufferSize;
UINT32 NumTimestamps;
DXGKARG_HISTORYBUFFERPRECISION Precision;
UINT32 Offset;
} DXGKARG_FORMATHISTORYBUFFER;
Anggota
pHistoryBuffer
Penunjuk ke buffer riwayat DXGK_HISTORY_BUFFER yang tidak diformat yang diisi oleh GPU.
HistoryBufferSize
Ukuran, dalam byte, dari buffer yang ditujukkan oleh pHistoryBuffer.
pFormattedBuffer
Penunjuk ke segmen memori sistem non-halaman yang digunakan driver untuk menyimpan info stempel waktu yang berasal dari buffer riwayat yang tidak diformat yang disediakan.
Buffer yang ditunjukkan oleh pFormattedBuffer harus dikelola sebagai array besar stempel waktu presisi yang ditentukan oleh Presisi. Buffer tidak boleh berisi info header apa pun yang sudah ada di buffer riwayat asli.
FormattedBufferSize
Ukuran, dalam byte, dari buffer yang ditunjukkan oleh pFormattedBuffer. Driver harus memastikan bahwa driver tidak menulis data di luar ukuran buffer ini.
NumTimestamps
Jumlah stempel waktu. Setelah menyelesaikan panggilan ke fungsi DxgkDdiFormatHistoryBuffer , driver harus mengatur nilai ini ke jumlah stempel waktu yang ditulis ke buffer berformat yang ditunjukkan oleh pFormattedBuffer.
Perhatikan bahwa jumlah stempel waktu yang akan berada dalam buffer output berformat tidak akan diketahui sampai driver menyelesaikan buffer yang diformat yang ditunjukkan oleh pFormattedBuffer.
Precision
Struktur DXGKARG_HISTORYBUFFERPRECISION yang diisi driver dengan info tentang presisi stempel waktu yang akan dicatat ke fasilitas Event Tracing for Windows (ETW).
Nilai DXGKARG_HISTORYBUFFERPRECISION. Anggota PrecisionBits tidak boleh nol.
Offset
Pada input ke panggilan ke fungsi DxgkDdiFormatHistoryBuffer , nilai anggota ini adalah offset ke stempel pertama kali di mana pemformatan harus dimulai. Setelah menyelesaikan panggilan fungsi, driver harus mengatur nilai ke nol jika berhasil memformat semua stempel waktu dalam buffer riwayat.
Jika bukan nol, driver tidak dapat memformat semua stempel waktu dalam buffer riwayat tanpa mengisi buffer yang diformat. Dalam hal ini, nilai mewakili offset yang harus dilanjutkan dari dalam panggilan fungsi berikutnya.
Keterangan
Driver harus mendapatkan entri stempel waktu dan jumlah stempel waktu yang dapat digunakan dari header buffer riwayat yang disediakan. Data tambahan apa pun yang dibutuhkan driver untuk penghitungan harus disimpan dalam data pribadi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 8.1,WDDM 1.3 dan yang lebih baru |
| Server minimum yang didukung | Windows Server 2012 R2 |
| Header | d3dkmddi.h (termasuk D3dkmddi.h) |