Win32 API 日本語リファレンス
ホームGraphics.Direct3D12 › ID3D12Device6

ID3D12Device6

COM
IIDc70b221b-40e4-4a17-89af-025a0727a6dc継承元ID3D12Device5自前メソッド開始 vtbl65

公式ドキュメント

仮想アダプターを表します。このインターフェイスは ID3D12Device5 を拡張します。

メソッド 1

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 65 HRESULT SetBackgroundProcessingMode(D3D12_BACKGROUND_PROCESSING_MODE Mode, D3D12_MEASUREMENTS_ACTION MeasurementsAction, HANDLE hEventToSignalUponCompletion, BOOL* pbFurtherMeasurementsDesired)

ドライバーによるバックグラウンド処理最適化のモードを設定します。

ModeD3D12_BACKGROUND_PROCESSING_MODEinこれ以降に送信される GPU 作業に対して適用する動的最適化のレベルです。
MeasurementsActionD3D12_MEASUREMENTS_ACTIONin以前のワークロード計測の結果に対して行う操作です。
hEventToSignalUponCompletionHANDLEinoptional関数の完了時にシグナル状態にするハンドル (省略可能)。たとえば、MeasurementsActionD3D12_MEASUREMENTS_ACTION_COMMIT_RESULTS が設定されている場合、結果として発生するすべてのコンパイルが完了した時点で hEventToSignalUponCompletion がシグナル状態になります。
pbFurtherMeasurementsDesiredBOOL*outoptionalブール値へのポインター (省略可能)。プロファイリングを継続すべき場合、関数はこの値に true を設定します。それ以外の場合は false を設定します。

解説(Remarks)

グラフィックス ドライバーは、アイドル優先度のバックグラウンド CPU スレッドを使用して、シェーダー プログラムを動的に再コンパイルすることがあります。これにより、実行中のハードウェアの詳細や使用状況に合わせてシェーダー コードを特殊化し、GPU パフォーマンスを向上させることができます。

開発者がこの機能の恩恵を受けるために特別な作業を行う必要はありません (ドライバーがバックグラウンド処理の最適化を採用するにつれて、既存のシェーダーは自動的により効率的にチューニングされます)。ただし、コードをプロファイリングする際には、タイミングを測定する前にドライバーのバックグラウンド処理最適化が完了していることを確認するために、SetBackgroundProcessingMode を呼び出すとよいでしょう。以下に例を示します。

SetBackgroundProcessingMode(
    D3D12_BACKGROUND_PROCESSING_MODE_ALLOW_INTRUSIVE_MEASUREMENTS,
    D3D_MEASUREMENTS_ACTION_KEEP_ALL,
    nullptr, nullptr);
 
// ここで、代表的なコンテンツをレンダリングしてシステムを準備します。
// たとえば、レベル内のフライスルーなどです。
 
SetBackgroundProcessingMode(
    D3D12_BACKGROUND_PROCESSING_MODE_ALLOWED,
    D3D12_MEASUREMENTS_ACTION_COMMIT_RESULTS,
    nullptr, nullptr);
 
// ここでレンダリングを続行します。今回は動的最適化が適用された状態です。
// その上で測定を行います。

PIXSetBackgroundProcessingMode を自動的に使用します—まずシステムを準備するために使用し、次に解析の途中でそれ以上の変更が発生しないようにするために使用します。PIX は、測定を開始する前に (バックグラウンドでのシェーダー再コンパイルがすべて完了したことを確認するため) イベントを待機します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"

出力引数:
#define global IID_ID3D12Device6 "{C70B221B-40E4-4A17-89AF-025A0727A6DC}"
#usecom global ID3D12Device6 IID_ID3D12Device6 "{}"
#comfunc global ID3D12Device6_SetBackgroundProcessingMode  65 int,int,sptr,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。