struktur DXGK_HISTORY_BUFFER_HEADER (d3dkmddi.h)

Menentukan bagaimana data disimpan dalam buffer riwayat DXGK_HISTORY_BUFFER .

Sintaks

typedef struct _DXGK_HISTORY_BUFFER_HEADER {
  UINT32 RenderCbSequence;
  UINT32 NumTimestamps;
  UINT32 PrivateDataSize;
  UINT32 Reserved;
} DXGK_HISTORY_BUFFER_HEADER;

Anggota

RenderCbSequence

Nilai D3DDDICB_RENDERFLAGS. Anggota nilai yang akan digunakan dalam panggilan ke fungsi pfnRenderCb .

Driver miniport tampilan harus menghitung nilai ini dan memasukkannya ke DXGK_HISTORY_BUFFER_HEADER sebelum memanggil pfnRenderCb.

NumTimestamps

Jumlah stempel waktu yang akan berada di buffer riwayat ketika buffer DMA menyelesaikan eksekusinya.

Driver harus menyertakan semua stempel waktu yang dicatat, bahkan jika buffer harus diformat sebelum dicatat ke fasilitas Pelacakan Peristiwa untuk Windows (ETW).

PrivateDataSize

Ukuran, dalam byte, dari data pribadi opsional yang disimpan driver. Driver dapat menggunakan data ini untuk tujuan apa pun.

Jika nol, driver tidak perlu menyimpan data pribadi di buffer riwayat.

Catatan Nilai ini harus kelipatan 8 byte untuk memastikan bahwa data stempel waktu selaras dengan batas 64-bit.

 

Jika buffer riwayat tidak perlu diformat ketika buffer DMA menyelesaikan eksekusinya, maka ketika subsistem kernel grafis DirectX menulis log ke ETW, ia menggunakan PrivateDataSize sebagai offset langsung dari header untuk mereferensikan stempel waktu.

Reserved

Dicadangkan untuk penggunaan sistem dan harus diatur ke nol.

Keterangan

Hanya porsi stempel waktu dari buffer riwayat, bersama dengan jumlah stempel waktu, yang akan dicatat ke ETW. Data header dan data driver pribadi tidak akan dicatat ke ETW sebagai bagian dari buffer stempel waktu. Namun, bagian header akan dicatat secara terpisah.

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)

Lihat juga

D3DDDICB_RENDERFLAGS

DXGK_HISTORY_BUFFER

pfnRenderCb