PFND3DDDI_SETMARKERMODEコールバック関数 (d3dumddi.h)
Windows イベント トレーシング (ETW) マーカー イベントの種類をサポートする必要があることをユーザー モードのディスプレイ ドライバーに通知します。 必要に応じて、Microsoft Direct3D レベル 9 ハードウェアで実行されている Windows ディスプレイ ドライバー モデル (WDDM) 1.3 以降のドライバーによって実装されます。 (Direct3D レンダリングのパフォーマンス向上の要件を参照してください)。より高度なハードウェアの場合、ドライバーは、SetMarkerMode 関数を実装する必要があります。
構文
PFND3DDDI_SETMARKERMODE Pfnd3dddiSetmarkermode;
HRESULT Pfnd3dddiSetmarkermode(
HANDLE hDevice,
D3DDDI_MARKERTYPE Type,
UINT Flags
)
{...}
パラメーター
hDevice
ディスプレイ デバイスへのハンドル (グラフィックス コンテキスト)。
Type
ドライバーがサポートする必要があるマーカー イベントの種類を示す D3DDDI_MARKERTYPE 列挙体の値。
Flags
ドライバーがコマンド バッファーにカスタム情報を提供する必要があるかどうかを示す UINT 値。 D3DDDI_SETMARKERMODE_CUSTOMDRIVEREVENTSに設定すると、ドライバーはカスタム イベント情報を使用してコマンド バッファーに注釈を付け、インストルメント化する必要があります。 それ以外の場合、ドライバーはコマンド バッファーに注釈を付けてはなりません。
注釈は、English-US ロケールのテキスト文字列の形式、または文字列テーブル内の場所に対するインデックス値の形式にすることができます。 後者のオプションの場合、ドライバーは、インデックス値が示す文字列を記述する関数も実装する必要があります。
戻り値
関数が正常に完了しない場合は、S_OK または適切なエラー結果を返します。
備考
D3DDDIMT_PROFILE の種類で示される、ユーザー モード ドライバーでプロファイルの種類のマーカー イベントを設定する場合は、次のガイドラインに従います。
- グラフィックス コマンドの境界との相関関係が強くない軽量インストルメンテーションを使用します。
- ドライバーは、グラフィックス パイプラインの最後に GPU タイム スタンプをサンプリングできる必要があります。
- 待機アイドル コマンドなど、グラフィックス パイプラインに高パフォーマンスの負荷をかけるサンプリング コマンドは使用しないでください。 プロファイルタイプのマーカー イベントをインストルメント化するには、ドライバーがパイプラインまたはキャッシュをフラッシュする必要はありません。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 8.1、WDDM 1.3 以降 |
サポートされる最小サーバー | Windows Server 2012 R2 |
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | d3dumddi.h (D3d10umddi.h を含む) |
関連項目
SetMarkerMode の