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に設定すると、ドライバーはカスタム イベント情報を使用してコマンド バッファーに注釈を付け、インストルメント化する必要があります。 それ以外の場合、ドライバーはコマンド バッファーに注釈を付けてはなりません。
注釈は、English-US ロケールのテキスト文字列の形式、または文字列テーブル内の場所に対するインデックス値の形式にすることができます。 後者のオプションの場合、ドライバーは、インデックス値が示す文字列を記述する関数も実装する必要があります。
戻り値
何一つ
備考
ドライバーは、pfnSetErrorCb コールバック関数を使用してエラー コードを設定できます。
D3DWDDM1_3DDI_MARKER_TYPE_PROFILE の種類で示される、ユーザー モード ドライバーでプロファイルの種類のマーカー イベントを設定する場合は、次のガイドラインに従います。
- グラフィックス コマンドの境界との相関関係が強くない軽量インストルメンテーションを使用します。
- ドライバーは、グラフィックス パイプラインの最後に GPU タイム スタンプをサンプリングできる必要があります。
- 待機アイドル コマンドなど、グラフィックス パイプラインに高パフォーマンスの負荷をかけるサンプリング コマンドは使用しないでください。 プロファイルタイプのマーカー イベントをインストルメント化するには、ドライバーがパイプラインまたはキャッシュをフラッシュする必要はありません。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8.1、WDDM 1.3 以降 |
| サポートされる最小サーバー | Windows Server 2012 R2 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | d3d10umddi.h (D3d10umddi.h を含む) |