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 バイトの倍数にする必要があります。

 

DMA バッファーの実行が完了したときに履歴バッファーを書式設定する必要がない場合は、DirectX グラフィックス カーネル サブシステムが ETW にログを書き込むときに、ヘッダーからの直接オフセットとして PrivateDataSize を使用してタイムスタンプを参照します。

Reserved

システム使用のために予約されており、0 に設定する必要があります。

注釈

タイム スタンプの数と共に、履歴バッファーのタイム スタンプ部分のみが ETW に記録されます。 ヘッダー データとプライベート ドライバー データは、タイム スタンプ バッファーの一部として ETW に記録されません。 ただし、ヘッダーの一部は個別にログに記録されます。

要件

要件	値
サポートされている最小のクライアント	Windows 8.1、WDDM 1.3 以降
サポートされている最小のサーバー	Windows Server 2012 R2
Header	d3dkmddi.h (D3dkmddi.h を含む)

こちらもご覧ください

D3DDDICB_RENDERFLAGS

DXGK_HISTORY_BUFFER

pfnRenderCb