PFND3D10DDI_SO_SETTARGETS Rückruffunktion (d3d10umddi.h)

  • Artikel

Die SoSetTargets-Funktion legt Streamausgabezielressourcen fest.

Syntax

PFND3D10DDI_SO_SETTARGETS Pfnd3d10ddiSoSettargets;

void Pfnd3d10ddiSoSettargets(
       D3D10DDI_HDEVICE unnamedParam1,
  [in] UINT NumBuffers,
  [in] UINT ClearTargets,
       const D3D10DDI_HRESOURCE *unnamedParam4,
       const UINT *unnamedParam5
)
{...}

Parameter

unnamedParam1

hDevice [in]

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

[in] NumBuffers

Die Anzahl der Elemente im Array, die phResource angibt.

[in] ClearTargets

Die Anzahl der Handles zum Streamen von Ausgabezielressourcen, die den Unterschied zwischen der vorherigen Anzahl der Streamausgabezielressourcen (bevor die Microsoft Direct3D-Runtime SoSetTargets aufruft) und der neuen Anzahl der Streamausgabezielressourcen darstellt.

Beachten Sie, dass die zahl, die iClearTargets angibt, nur eine Optimierungshilfe ist, da der Benutzermodusanzeigetreiber diese Zahl berechnen könnte.

unnamedParam4

phResource [in]

Ein Array von Handles für die festzulegenden Streamausgabezielressourcen. Beachten Sie, dass einige Handle-Werte NULL sein können.

unnamedParam5

pOffsets [in]

Ein Array von Offsets in Bytes in den Streamausgabezielressourcen in dem Array, das phResource angibt.

Rückgabewert

Keine

Bemerkungen

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

Der Bereich der Streamausgabezielressourcen zwischen der Anzahl, die der SOTargets-Parameter angibt, und der maximalen Anzahl der zulässigen Streamausgabezielressourcen muss alle NULL - oder ungebundenen Werte enthalten. Die Zahl, die der ClearTargets-Parameter angibt, informiert den Treiber darüber, wie viele Bindungspunkte der Treiber für den aktuellen Vorgang löschen muss. Wenn der vorherige Aufruf von SoSetTargets den Wert 2 in SOTargetsübergeben hat und der aktuelle Aufruf von SoSetTargets den Wert 4 in SOTargets übergibt, übergibt der aktuelle Aufruf von SoSetTargets auch den Wert 0 im ClearTargets-Parameter . Wenn der nächste aufeinanderfolgende Aufruf von SoSetTargets den Wert 1 in SOTargets übergibt, übergibt der nachfolgende Aufruf auch den Wert 3 (4 - 1) in ClearTargets.

Für den Treiber sollte kein Fehler auftreten, mit Ausnahme von D3DDDIERR_DEVICEREMOVED. Wenn der Treiber bei einem Aufruf der PfnSetErrorCb-Funktion einen Fehler mit Ausnahme von D3DDDIERR_DEVICEREMOVED übergibt, ermittelt die Microsoft Direct3D-Runtime daher, dass der Fehler kritisch ist. Selbst wenn das Gerät entfernt wurde, muss der Treiber nicht D3DDDIERR_DEVICEREMOVED zurückgeben. Wenn die Geräteentfernung jedoch den Betrieb von SOTargets beeinträchtigt hat (was normalerweise nicht geschehen sollte), kann der Treiber D3DDDIERR_DEVICEREMOVED zurückgeben.

Anforderungen

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

Weitere Informationen

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb