PFND3D10DDI_CREATERASTERIZERSTATE Rückruffunktion (d3d10umddi.h)
Die CreateRasterizerState--Funktion erstellt einen Rasterizerstatus.
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 Anzeigetreiber für den Benutzermodus zum Erstellen eines Rasterizerzustands verwendet.
unnamedParam3
hRasterizerState [in]
Ein Handle für die privaten Daten des Treibers für den Rasterizerzustand. Der Treiber gibt die Größe des Speicherbereichs in Bytes zurück, den die Microsoft Direct3D-Laufzeit für die privaten Daten aus einem Aufruf der CalcPrivateRasterizerStateSize Funktion des Treibers zuordnen muss. Das Handle ist wirklich nur ein Zeiger auf einen Speicherbereich, dessen Größe der Treiber angefordert hat. Der Treiber verwendet diesen Speicherbereich, um interne Datenstrukturen zu speichern, die sich auf das Rasterizerstatusobjekt beziehen.
unnamedParam4
hRTRasterizerState [in]
Ein Handle zum Rasterizerstatus, den der Treiber verwenden sollte, wenn er wieder in die Direct3D-Laufzeit aufruft.
Rückgabewert
Nichts
Bemerkungen
Der Treiber kann die pfnSetErrorCb Rückruffunktion verwenden, um einen Fehlercode festzulegen.
Der Treiber kann E_OUTOFMEMORY übergeben (wenn der Treiber nicht genügend Arbeitsspeicher hat) oder D3DDDIERR_DEVICEREMOVED (wenn das Gerät entfernt wurde) in einem Aufruf der pfnSetErrorCb-Funktion. Die Direct3D-Laufzeit bestimmt, dass alle anderen Fehler kritisch sind. Wenn der Treiber Fehler, einschließlich D3DDDIERR_DEVICEREMOVED, übergibt, bestimmt die Direct3D-Laufzeit, dass das Handle ungültig ist. Daher ruft die Laufzeit die DestroyRasterizerState-Funktion nicht auf, um das Handle zu zerstören, das der hRasterizerState Parameter angibt.
Der Anzeigetreiber für den Benutzermodus ist nicht erforderlich, um gleichzeitig mehr als 4.096 eindeutige Instanzen von Rasterizerzustandsobjekten auf einem Gerät zu erstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Desktop |
| Header- | d3d10umddi.h (include D3d10umddi.h) |