PFND3DWDDM1_3DDI_SETMARKERMODE コールバック関数 (d3d10umddi.h)
Windows イベント トレーシング (ETW) マーカー イベントの種類をサポートする必要があることをユーザー モード ディスプレイ ドライバーに通知します。 Windows ディスプレイ ドライバー モデル (WDDM) 1.3 以降のドライバーで実装する必要があります。
構文
PFND3DWDDM1_3DDI_SETMARKERMODE Pfnd3dwddm13DdiSetmarkermode;
void Pfnd3dwddm13DdiSetmarkermode(
D3D10DDI_HDEVICE hDevice,
D3DWDDM1_3DDI_MARKER_TYPE Type,
UINT Flags
)
{...}
パラメーター
hDevice
ディスプレイ デバイスへのハンドル (グラフィックス コンテキスト)。
Type
ドライバーがサポートする必要があるマーカー イベントの種類を示す、 D3DWDDM1_3DDI_MARKER_TYPE 列挙からの値。
Flags
ドライバーがコマンド バッファーにカスタム情報を提供する必要があるかどうかを示す UINT 値。 D3DWDDM1_3DDI_SETMARKERMODE_CUSTOMDRIVEREVENTSに設定した場合、ドライバーはカスタム イベント情報を使用してコマンド バッファーに注釈を付け、インストルメント化する必要があります。 それ以外の場合、ドライバーはコマンド バッファーに注釈を付けないようにする必要があります。
注釈は、英語と米国のロケールのテキスト文字列の形式、または文字列テーブル内の場所へのインデックス値の形式にすることができます。 後者のオプションの場合、ドライバーは、インデックス値が示す文字列を記述する関数も実装する必要があります。
戻り値
なし
解説
ドライバーは、 pfnSetErrorCb コールバック関数を使用してエラー コードを設定できます。
D3DWDDM1_3DDI_MARKER_TYPE_PROFILEの種類で示されるユーザー モード ドライバーでプロファイル の種類の マーカー イベントを設定するときは、次のガイドラインに従います。
- グラフィックス コマンド境界との強い相関関係を生成しない軽量インストルメンテーションを使用します。
- ドライバーは、グラフィックス パイプラインの最後に GPU タイム スタンプをサンプリングできる必要があります。
- アイドル待機コマンドなど、グラフィックス パイプラインに高いパフォーマンス負荷を掛けるサンプリング コマンドは使用しないでください。 プロファイルタイプのマーカーイベントをインストルメント化するには、ドライバーがパイプラインまたはキャッシュをフラッシュする必要はありません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8.1、WDDM 1.3 以降 |
| サポートされている最小のサーバー | Windows Server 2012 R2 |
| 対象プラットフォーム | デスクトップ |
| Header | d3d10umddi.h (D3d10umddi.h を含む) |