PFND3D10DDI_CREATERASTERIZERSTATE Rückruffunktion (d3d10umddi.h)

Die CreateRasterizerState-Funktion erstellt einen Rasterizerzustand.

Syntax

PFND3D10DDI_CREATERASTERIZERSTATE Pfnd3d10ddiCreaterasterizerstate;

void Pfnd3d10ddiCreaterasterizerstate(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D10_DDI_RASTERIZER_DESC *unnamedParam2,
  D3D10DDI_HRASTERIZERSTATE unnamedParam3,
  D3D10DDI_HRTRASTERIZERSTATE unnamedParam4
)
{...}

Parameter

unnamedParam1

hDevice [in]

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

unnamedParam2

pRasterizerDesc [in]

Ein Zeiger auf eine D3D10_DDI_RASTERIZER_DESC-Struktur , die die Parameter beschreibt, die der Benutzermodusanzeigetreiber zum Erstellen eines Rasterisierungszustands verwendet.

unnamedParam3

hRasterizerState [in]

Ein Handle für die privaten Daten des Treibers für den Rasterizerstatus. Der Treiber gibt die Größe des Arbeitsspeicherbereichs in Bytes zurück, die die Microsoft Direct3D-Runtime den privaten Daten aus einem Aufruf der CalcPrivateRasterizerStateSize-Funktion des Treibers zuordnen muss. Das Handle ist eigentlich nur ein Zeiger auf einen Bereich des Arbeitsspeichers, dessen Größe der Treiber angefordert hat. Der Treiber verwendet diesen Bereich des Arbeitsspeichers, um interne Datenstrukturen zu speichern, die sich auf sein Rasterizerzustandsobjekt beziehen.

unnamedParam4

hRTRasterizerState [in]

Ein Handle für den Rasterizer-Zustand, 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 DestroyRasterizerState-Funktion nicht auf, um das Handle zu zerstören, das der hRasterizerState-Parameter angibt.

Der Anzeigetreiber für den Benutzermodus muss nicht mehr als 4.096 eindeutige Instanzen von Rasterizer-State-Objekten gleichzeitig auf einem Gerät 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)

Weitere Informationen

CalcPrivateRasterizerStateSize

D3D10DDI_DEVICEFUNCS

D3D10_DDI_RASTERIZER_DESC

DestroyRasterizerState

pfnSetErrorCb