ID3D12Device::CreateDepthStencilView-Methode (d3d12.h)

  • Artikel

Erstellt eine Tiefenschablonenansicht für den Zugriff auf Ressourcendaten.

Syntax

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

Parameter

[in, optional] pResource

Typ: ID3D12Resource*

Ein Zeiger auf das ID3D12Resource-Objekt , das die Tiefenschablone darstellt.

Mindestens eine von pResource oder pDesc muss bereitgestellt werden. Ein Null pResource wird verwendet, um einen NULL-Deskriptor zu initialisieren, der D3D11-ähnliches NULL-Bindungsverhalten garantiert (lese 0s, Schreibvorgänge werden verworfen), muss jedoch über einen gültigen pDesc verfügen, um den Deskriptortyp zu bestimmen.

[in, optional] pDesc

Typ: const D3D12_DEPTH_STENCIL_VIEW_DESC*

Ein Zeiger auf eine D3D12_DEPTH_STENCIL_VIEW_DESC Struktur, die die Tiefenschablonenansicht beschreibt.

Ein null pDesc wird verwendet, um nach Möglichkeit einen Standarddeskriptor zu initialisieren. Dieses Verhalten ist identisch mit dem D3D11-NULL-Deskriptorverhalten, bei dem Standardwerte eingegeben werden. Dieses Verhalten erbt das Ressourcenformat und die Dimension (wenn nicht typlos), und DSVs zielen auf den ersten mip und alle Arrays slices ab. Nicht alle Ressourcen unterstützen die NULL-Deskriptorinitialisierung.

[in] DestDescriptor

Typ: D3D12_CPU_DESCRIPTOR_HANDLE

Beschreibt das CPU-Deskriptorhandle, das den Start des Heaps darstellt, der die Tiefenschablonenansicht enthält.

Rückgabewert

Keine

Anforderungen

   
Zielplattform Windows
Kopfzeile d3d12.h
Bibliothek D3D12.lib
DLL D3D12.dll

Weitere Informationen

ID3D12Device