ID3D12StateObjectProperties

ID3D12StateObject のプロパティを取得および設定するためのメソッドを提供します。

シェーダーレコードで使用できる、シェーダーの一意な識別子を取得します。

シェーダー識別子へのポインター。

このポインターが参照するデータは、取得元のステートオブジェクトが有効である間、有効です。返されるデータのサイズは D3D12_SHADER_IDENTIFIER_SIZE_IN_BYTES です。この識別子を何度も取得する必要がある場合は、ステートオブジェクト内を検索するコストを避けるため、アプリケーションはこのデータをコピーしてキャッシュしてください。この識別子は、アプリが値を設定する必要がある GPU メモリ上のシェーダーテーブル内のシェーダーレコードで使用されます。

このデータ自体がシェーダーをグローバルに識別するため、ルートシグネチャなどの関連付けが同じであれば、別のステートオブジェクトに同じシェーダーが現れた場合でも同一の識別子になります。

シェーダーがステートオブジェクト内で完全に解決されていない場合、戻り値は nullptr になります。

HLSL のレイトレーシングシェーダーを呼び出すために必要なスタックメモリの量を取得します。

シェーダーの呼び出しに必要なスタックメモリの量 (バイト単位)。シェーダーがステートオブジェクト内で完全に解決されていない場合、シェーダーが不明な場合、またはヒットグループのようにスタックサイズが関係しない種類のシェーダーである場合、戻り値は 0xffffffff になります。UINT64 の戻り値に対して 32 ビットの 0xffffffff という値を使用するのは、パイプライン全体のスタックサイズを計算するために他の値と合算した際に、不正な戻り値が埋もれてしまわないようにするためです。

このメソッドを呼び出す必要があるのは、保守的な既定のスタックサイズに頼るのではなく、SetPipelineStackSize を呼び出してスタックサイズを構成したい場合のみです。このメソッドは、レイ生成シェーダー、ヒットグループ、ミスシェーダー、および呼び出し可能シェーダーに対してのみ有効です。レイ生成シェーダーはスタックの最下部に位置しますが、それでも 0 以外の値を返すことがあります。

ヒットグループの場合は、それを構成する個々のシェーダー (インターセクションシェーダー、エニーヒットシェーダー、クローゼストヒットシェーダー) ごとにスタックサイズを照会する必要があります。それぞれ必要なスタックサイズが異なる可能性が高いためです。これらの個々のシェーダーに対して直接スタックサイズを照会することはできません。コンパイルのされ方が、それらを含むヒットグループ全体の影響を受ける可能性があるためです。pExportName パラメーターには、ヒットグループ内の個々のシェーダーを識別するための構文が用意されています。

この API は、コレクションステートオブジェクトとレイトレーシングパイプラインステートオブジェクトのいずれに対しても呼び出すことができます。

現在のパイプラインスタックサイズを取得します。

現在のパイプラインスタックサイズ (バイト単位)。コレクションなど、実行可能でないステートオブジェクトに対して呼び出した場合、戻り値は 0 になります。

このメソッドと SetPipelineStackSize はリエントラントではありません。つまり、いずれか一方または両方を別々のスレッドから呼び出す場合、アプリ側で同期を行う必要があります。

現在のパイプラインスタックサイズを設定します。

このメソッドと GetPipelineStackSize はリエントラントではありません。つまり、いずれか一方または両方を別々のスレッドから呼び出す場合、アプリ側で同期を行う必要があります。

ランタイムは、コレクションなど、レイトレーシングパイプライン以外のステートオブジェクトに対する呼び出しを破棄します。