ID3D11ShaderTrace::GetInitialRegisterContents メソッド (d3d11shadertracing.h)

  • [アーティクル]

指定した入力レジスタの初期内容を取得します。

構文

HRESULT GetInitialRegisterContents(
  [in]  D3D11_TRACE_REGISTER *pRegister,
  [out] D3D11_TRACE_VALUE    *pValue
);

パラメーター

[in] pRegister

初期コンテンツを取得する入力レジスタを記述する D3D11_TRACE_REGISTER 構造体へのポインター。 有効な初期データは、次の入力レジスタの種類からのみ取得できます。 つまり、有効なデータを取得するには、D3D11_TRACE_REGISTERの RegType メンバーが次のいずれかの値である必要があります。

  • D3D11_TRACE_INPUT_REGISTER
  • D3D11_TRACE_INPUT_PRIMITIVE_ID_REGISTER
  • D3D11_TRACE_IMMEDIATE_CONSTANT_BUFFER
有効なデータは、pValue が指すD3D11_TRACE_VALUE構造体の ValidMask メンバーによって示されます。

[out] pValue

D3D11_TRACE_VALUE構造体へのポインター。 GetInitialRegisterContents は、この構造体のメンバーに初期コンテンツに関する情報を入力します。

戻り値

GetInitialRegisterContents は次を返します。

  • メソッドが初期レジスタの内容を取得する場合にS_OKします。
  • トレースが使用できない場合は、E_FAILします。
  • pRegister が無効か NULL か、pValue が NULL の場合にE_INVALIDARGします。
  • Direct3D 11 リターン コードで説明されているその他のエラー コードが考えられます。

注釈

pRegister パラメーターの説明で指定されている入力レジスタ型以外のレジスタに対して GetInitialRegisterContents を呼び出すことができます。 ただし、GetInitialRegisterContents は、pValue が指すD3D11_TRACE_VALUE構造体の ValidMask メンバーを空 (すべてのゼロ、0000) に設定し、D3D11_TRACE_VALUEの Bits メンバーが指定するレジスタ値は意味がありません。 GetInitialRegisterContents から返されるデータは、トレースのステップインによる影響を受けません。ただし、返されるデータは、ID3D11ShaderTrace::P SSelectStamp の呼び出しによってスタンプ インデックスを変更することによって影響を受けます。

メモこの API には、Windows 8用の Windows ソフトウェア開発キット (SDK) が必要です。
 

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー d3d11shadertracing.h
[DLL] D3D11SDKLayers.dll;D3D11_1SDKLayers.dll;D3D11_2SDKLayers.dll

こちらもご覧ください

ID3D11ShaderTrace