D3D12_DEPTH_STENCIL_DESC

深度ステンシル状態を記述します。

構文

typedef struct D3D12_DEPTH_STENCIL_DESC
{
    BOOL DepthEnable;
    D3D12_DEPTH_WRITE_MASK DepthWriteMask;
    D3D12_COMPARISON_FUNC DepthFunc;
    BOOL StencilEnable;
    UINT8 StencilReadMask;
    UINT8 StencilWriteMask;
    D3D12_DEPTH_STENCILOP_DESC FrontFace;
    D3D12_DEPTH_STENCILOP_DESC BackFace;
} D3D12_DEPTH_STENCIL_DESC

メンバー

DepthEnable
型: BOOL 深度テストを有効にするかどうかを指定します。深度テストを有効にするには、このメンバーを TRUE に設定します。 DepthWriteMask
型: D3D12_DEPTH_WRITE_MASK 深度データによって変更できる深度ステンシルバッファーの一部を識別する D3D12_DEPTH_WRITE_MASK 型の値。 DepthFunc
型: D3D12_COMPARISON_FUNC 既存の深度データに対して深度データを比較する関数を識別する D3D12_COMPARISON_FUNC 型の値。 StencilEnable
型: BOOL ステンシルテストを有効にするかどうかを指定します。ステンシルテストを有効にするには、このメンバーを TRUE に設定します。 StencilReadMask
型: UINT8 ステンシルデータを読み取るために、深度ステンシルバッファーの一部を識別します。 StencilWriteMask
型: UINT8 ステンシルデータを書き込むために、深度ステンシルバッファーの一部を識別します。 FrontFace
型: D3D12_DEPTH_STENCILOP_DESC 表面法線がカメラの方向を向いているピクセルに対して、深度テストとステンシルテストの結果をどのように使用するかを記述する D3D12_DEPTH_STENCILOP_DESC 構造体。 BackFace
型: D3D12_DEPTH_STENCILOP_DESC 表面法線がカメラの方向から離れているピクセルに対して、深度テストとステンシルテストの結果をどのように使用するかを記述する D3D12_DEPTH_STENCILOP_DESC 構造体。

解説

D3D12_GRAPHICS_PIPELINE_STATE_DESC オブジェクトには、出力マージステージによる深度ステンシルテストの実行方法を制御する深度ステンシル状態構造体が含まれています。次の表は、深度ステンシル状態の既定値を示しています。

状態	既定値
DepthEnable	TRUE
DepthWriteMask	D3D12_DEPTH_WRITE_MASK_ALL
DepthFunc	D3D12_COMPARISON_FUNC_LESS
StencilEnable	FALSE
StencilReadMask	D3D12_DEFAULT_STENCIL_READ_MASK
StencilWriteMask	D3D12_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFailOpおよびBackFace.StencilFailOp	D3D12_STENCIL_OP_KEEP
FrontFace.StencilDepthFailOpおよびBackFace.StencilDepthFailOp	D3D12_STENCIL_OP_KEEP
FrontFace.StencilPassOpおよびBackFace.StencilPassOp	D3D12_STENCIL_OP_KEEP
FrontFace.StencilFuncおよびBackFace.StencilFunc	D3D12_COMPARISON_FUNC_ALWAYS

ステンシルをサポートするフォーマットは、DXGI_FORMAT_D24_UNORM_S8_UINT および DXGI_FORMAT_D32_FLOAT_S8X24_UINT です。

要件

ヘッダー: d3d12_xs.h または d3d12_x.h
ライブラリ: d3d12_xs.lib または d3d12_x.lib
サポートされるプラットフォーム: XBOX Series 本体および XBOX One ファミリ

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

構文

メンバー

解説

要件

関連項目

​構文

​メンバー

​解説

​要件

​関連項目

構文

メンバー

解説

要件

関連項目