PFND3D10DDI_CREATEDEPTHSTENCILSTATE Rückruffunktion (d3d10umddi.h)

Artikel
02/22/2024

Die CreateDepthStencilState-Funktion erstellt einen Tiefenschablonenzustand.

Syntax

PFND3D10DDI_CREATEDEPTHSTENCILSTATE Pfnd3d10ddiCreatedepthstencilstate;

void Pfnd3d10ddiCreatedepthstencilstate(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D10_DDI_DEPTH_STENCIL_DESC *unnamedParam2,
  D3D10DDI_HDEPTHSTENCILSTATE unnamedParam3,
  D3D10DDI_HRTDEPTHSTENCILSTATE unnamedParam4
)
{...}

Parameter

unnamedParam1

hDevice [in]

Ein Handle für das Anzeigegerät (Grafikkontext).

unnamedParam2

pDepthStencilDesc [in]

Ein Zeiger auf eine D3D10_DDI_DEPTH_STENCIL_DESC Struktur, die die Parameter beschreibt, die der Benutzermodusanzeigetreiber verwendet, um einen Tiefenschablonenzustand zu erstellen.

unnamedParam3

hDepthStencilState [in]

Ein Handle für die privaten Daten des Treibers für den Tiefenschablonenzustand.

unnamedParam4

hRTDepthStencilState [in]

Ein Handle zum Tiefenschablonenzustand, den der Treiber bei jedem Aufruf in die Direct3D-Runtime verwenden sollte.

Rückgabewert

Keine

Bemerkungen

Der Treiber kann die Rückruffunktion pfnSetErrorCb verwenden, um einen Fehlercode festzulegen.

Der Treiber kann E_OUTOFMEMORY (wenn der Treiber nicht genügend Arbeitsspeicher hat) oder D3DDDIERR_DEVICEREMOVED (wenn das Gerät entfernt wurde) in einem Aufruf der pfnSetErrorCb-Funktion übergeben. Die Direct3D-Runtime bestimmt, dass alle anderen Fehler kritisch sind. Wenn der Treiber Fehler, einschließlich D3DDDIERR_DEVICEREMOVED, übergibt, ermittelt die Direct3D-Runtime, dass das Handle ungültig ist. Daher ruft die Runtime die DestroyDepthStencilState-Funktion nicht auf, um das Handle zu zerstören, das der Parameter hDepthStencilState angibt.

Der Anzeigetreiber für den Benutzermodus ist nicht erforderlich, um mehr als 4.096 eindeutige Instanzen von Tiefenschablonenzustandsobjekten gleichzeitig auf einem Gerät zu erstellen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	d3d10umddi.h (include D3d10umddi.h)