DXGKARG_FORMATHISTORYBUFFER構造体 (d3dkmddi.h)
履歴バッファーを書式設定するディスプレイ ミニポート ドライバーの情報が含まれています。
構文
typedef struct _DXGKARG_FORMATHISTORYBUFFER {
DXGK_HISTORY_BUFFER *pHistoryBuffer;
UINT32 HistoryBufferSize;
PVOID pFormattedBuffer;
UINT32 FormattedBufferSize;
UINT32 NumTimestamps;
DXGKARG_HISTORYBUFFERPRECISION Precision;
UINT32 Offset;
} DXGKARG_FORMATHISTORYBUFFER;
メンバーズ
pHistoryBuffer
GPU によって設定された書式設定されていない DXGK_HISTORY_BUFFER 履歴バッファーへのポインター。
HistoryBufferSize
pHistoryBuffer によって指バッファーのサイズ (バイト単位)。
pFormattedBuffer
指定された書式設定されていない履歴バッファーから派生したタイム スタンプ情報を格納するためにドライバーが使用する、ページ化されていないシステム メモリのセグメントへのポインター。
pFormattedBuffer 指すバッファーは、精度 で指定された有効桁数の大きなタイム スタンプ配列として管理する必要があります。 バッファーには、元の履歴バッファーに既に存在するヘッダー情報を含めないでください。
FormattedBufferSize
pFormattedBuffer によって指バッファーのサイズ (バイト単位)。 ドライバーは、このバッファー サイズを超えてデータを書き込まないことを確認する必要があります。
NumTimestamps
タイム スタンプの数。 DxgkDdiFormatHistoryBuffer 関数の呼び出しが完了すると、ドライバーは、pFormattedBuffer によって指書式設定されたバッファーに書き込まれるタイム スタンプの数にこの値を設定する必要があります。
書式設定された出力バッファー内にあるタイム スタンプの数は、ドライバーが pFormattedBuffer が指す書式設定されたバッファー完了するまで認識されません。
Precision
ドライバーが Windows イベント トレーシング (ETW) 機能に記録されるタイムスタンプの精度に関する情報を入力する DXGKARG_HISTORYBUFFERPRECISION 構造体。
DXGKARG_HISTORYBUFFERPRECISIONの値。PrecisionBits メンバーを 0 にすることはできません。
Offset
DxgkDdiFormatHistoryBuffer 関数の呼び出しへの入力時に、このメンバーの値は、書式設定を開始する最初のタイムスタンプへのオフセットです。 関数呼び出しが完了すると、履歴バッファー内のすべてのタイム スタンプが正常に書式設定された場合、ドライバーは値を 0 に設定する必要があります。
0 以外の場合、ドライバーは、書式設定されたバッファーを入力せずに、履歴バッファー内のすべてのタイム スタンプを書式設定できませんでした。 この場合、値は、次の関数呼び出しで継続する必要があるオフセットを表します。
備考
ドライバーは、指定された履歴バッファーのヘッダーからタイム スタンプ エントリと使用可能なタイム スタンプの数を取得する必要があります。 ドライバーが計算に必要とする追加データは、プライベート データに格納する必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8.1、WDDM 1.3 以降 |
| サポートされる最小サーバー | Windows Server 2012 R2 |
| ヘッダー | d3dkmddi.h (D3dkmddi.h を含む) |