Método ID3D12Device::CreateDepthStencilView (d3d12.h)

Artigo
03/05/2025

Cria uma exibição de estêncil de profundidade para acessar dados de recursos.

Sintaxe

void CreateDepthStencilView(
  [in, optional] ID3D12Resource                      *pResource,
  [in, optional] const D3D12_DEPTH_STENCIL_VIEW_DESC *pDesc,
  [in]           D3D12_CPU_DESCRIPTOR_HANDLE         DestDescriptor
);

Parâmetros

[in, optional] pResource

Tipo: ID3D12Resource*

Um ponteiro para o objeto ID3D12Resource que representa o estêncil de profundidade.

Pelo menos um pResource ou pDesc deve ser fornecido. Um pResource nulo é usado para inicializar um descritor nulo, que garante um comportamento de associação nula semelhante a D3D11 (leitura 0s, gravações são descartadas), mas deve ter uma pDesc de válida para determinar o tipo de descritor.

[in, optional] pDesc

Tipo: const D3D12_DEPTH_STENCIL_VIEW_DESC*

Um ponteiro para uma estrutura D3D12_DEPTH_STENCIL_VIEW_DESC que descreve a exibição de estêncil de profundidade.

Um pDesc nulo é usado para inicializar um descritor padrão, se possível. Esse comportamento é idêntico ao comportamento do descritor nulo D3D11, em que os padrões são preenchidos. Esse comportamento herda o formato e a dimensão do recurso (se não sem tipo) e os DSVs direcionam o primeiro mip e todas as fatias de matriz. Nem todos os recursos dão suporte à inicialização do descritor nulo.

[in] DestDescriptor

Tipo: D3D12_CPU_DESCRIPTOR_HANDLE

Descreve o identificador do descritor de CPU que representa o início do heap que contém a exibição de estêncil de profundidade.

Valor de retorno

Nenhum

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	d3d12.h
biblioteca	D3D12.lib
de DLL	D3D12.dll

Consulte também

ID3D12Device

Compartilhar via