IDirect3DDevice9Ex::CreateDepthStencilSurfaceEx-Methode (d3d9.h)

Artikel
02/26/2024

Erstellt eine Tiefenschablonenoberfläche.

Syntax

HRESULT CreateDepthStencilSurfaceEx(
  [in]          UINT                Width,
  [in]          UINT                Height,
  [in]          D3DFORMAT           Format,
  [in]          D3DMULTISAMPLE_TYPE MultiSample,
  [in]          DWORD               MultisampleQuality,
  [in]          BOOL                Discard,
  [out, retval] IDirect3DSurface9   **ppSurface,
  [in]          HANDLE              *pSharedHandle,
  [in]          DWORD               Usage
);

Parameter

[in] Width

Typ: UINT

Breite der Tiefenschablonenoberfläche in Pixel.

[in] Height

Typ: UINT

Höhe der Tiefenschablonenoberfläche in Pixel.

[in] Format

Typ: D3DFORMAT

Member des D3DFORMAT aufgezählten Typs, der das Format der Tiefenschablonenoberfläche beschreibt. Dieser Wert muss eines der aufgezählten Tiefenschablonenformate für dieses Gerät sein.

[in] MultiSample

Typ: D3DMULTISAMPLE_TYPE

Member des D3DMULTISAMPLE_TYPE aufgezählten Typs, der den Multisamplingpuffertyp beschreibt. Dieser Wert muss einer der zulässigen Multisampeltypen sein. Wenn diese Oberfläche an IDirect3DDevice9::SetDepthStencilSurface übergeben wird, muss der Multisampeltyp mit dem des von IDirect3DDevice9::SetRenderTarget festgelegten Renderziels identisch sein.

[in] MultisampleQuality

Typ: DWORD

Qualitätsstufe. Der gültige Bereich liegt zwischen 0 und eins kleiner als die von pQualityLevels zurückgegebene Ebene, die von IDirect3D9::CheckDeviceMultiSampleType verwendet wird. Wenn Sie einen größeren Wert übergeben, wird der Fehler D3DERR_INVALIDCALL zurückgegeben. Die MultisampleQuality-Werte von gekoppelten Renderzielen, Tiefenschablonenoberflächen und der MultiSample-Typ müssen alle übereinstimmen.

[in] Discard

Typ: BOOL

Legen Sie dieses Flag auf TRUE fest, um das Verwerfen von Z-Puffern zu aktivieren, andernfalls AUF FALSE . Wenn dieses Flag festgelegt ist, ist der Inhalt des Tiefenschablonenpuffers ungültig, nachdem entweder IDirect3DDevice9::P resent oder IDirect3DDevice9::SetDepthStencilSurface mit einer anderen Tiefenoberfläche aufgerufen wurde.

Dieses Flag hat das gleiche Verhalten wie die Konstante D3DPRESENTFLAG_DISCARD_DEPTHSTENCIL in D3DPRESENTFLAG.

[out, retval] ppSurface

Typ: IDirect3DSurface9**

Adresse eines Zeigers auf eine IDirect3DSurface9-Schnittstelle , die die erstellte Tiefenschablonen-Oberflächenressource darstellt.

[in] pSharedHandle

Typ: HANDLE*

Reserviert. Legen Sie diesen Parameter auf NULL fest. Dieser Parameter kann in Direct3D 9 für Windows Vista zum Freigeben von Ressourcen verwendet werden.

[in] Usage

Typ: DWORD

Kombination aus einer oder mehreren D3DUSAGE Konstanten, die zusammen ODER sein können. Der Wert 0 gibt an, dass keine Verwendung verwendet wird.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert wie folgt aussehen: D3DERR_NOTAVAILABLE, D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Hinweise

Die Speicherklasse des Tiefenschablonenpuffers ist immer D3DPOOL_DEFAULT.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	d3d9.h
Bibliothek	D3D9.lib

Weitere Informationen

IDirect3DDevice9Ex

Freigeben über