DXGK_HISTORY_BUFFER_HEADER 構造体 (d3dkmddi.h)
DXGK_HISTORY_BUFFER履歴バッファーにデータを格納する方法を指定します。
構文
typedef struct _DXGK_HISTORY_BUFFER_HEADER {
UINT32 RenderCbSequence;
UINT32 NumTimestamps;
UINT32 PrivateDataSize;
UINT32 Reserved;
} DXGK_HISTORY_BUFFER_HEADER;
メンバー
RenderCbSequence
D3DDDICB_RENDERFLAGSの値。pfnRenderCb 関数の呼び出しで使用される値メンバー。
ディスプレイ ミニポート ドライバーは、この値を計算し、pfnRenderCb を呼び出す前にDXGK_HISTORY_BUFFER_HEADERに入力する必要があります。
NumTimestamps
DMA バッファーの実行が完了したときに履歴バッファーに格納されるタイム スタンプの数。
ドライバーには、Windows イベント トレーシング (ETW) 機能に記録される前にバッファーを書式設定する必要がある場合でも、ログに記録されるすべてのタイム スタンプを含める必要があります。
PrivateDataSize
ドライバーが格納するオプションのプライベート データのサイズ (バイト単位)。 ドライバーは、任意の目的でこのデータを使用できます。
0 の場合、ドライバーは履歴バッファーにプライベート データを格納する必要はありません。
メモ タイム スタンプ データが 64 ビット境界に確実にアラインされるようにするには、この値は 8 バイトの倍数にする必要があります。
Reserved
システム使用のために予約されており、0 に設定する必要があります。
注釈
タイム スタンプの数と共に、履歴バッファーのタイム スタンプ部分のみが ETW に記録されます。 ヘッダー データとプライベート ドライバー データは、タイム スタンプ バッファーの一部として ETW に記録されません。 ただし、ヘッダーの一部は個別にログに記録されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8.1、WDDM 1.3 以降 |
| サポートされている最小のサーバー | Windows Server 2012 R2 |
| Header | d3dkmddi.h (D3dkmddi.h を含む) |