PFND3D10DDI_SO_SETTARGETS Rückruffunktion (d3d10umddi.h)
Die SoSetTargets--Funktion legt Datenstromausgabezielressourcen 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 für Streamausgabezielressourcen, die den Unterschied zwischen der vorherigen Anzahl der Streamausgabezielressourcen (vor den Microsoft Direct3D-Laufzeitaufrufen SoSetTargets) und der neuen Anzahl der Streamausgabezielressourcen darstellt.
Beachten Sie, dass die Zahl, die iClearTargets- angibt, nur eine Optimierungshilfe ist, da der Anzeigetreiber für den Benutzermodus diese Zahl berechnen könnte.
unnamedParam4
phResource [in]
Ein Array von Handles für die festzulegenden Datenstromausgabezielressourcen. Beachten Sie, dass einige Handlewerte NULL-sein können.
unnamedParam5
pOffsets [in]
Ein Array von Offsets in Byte in den Datenstromausgabezielressourcen im Array, das phResource- angibt.
Rückgabewert
Nichts
Bemerkungen
Der Treiber kann die pfnSetErrorCb Rückruffunktion verwenden, um einen Fehlercode festzulegen.
Der Bereich der Datenstromausgabezielressourcen zwischen der Zahl, die der SOTargets Parameter angibt, und die maximale Anzahl der zulässigen Streamausgabezielressourcen ist erforderlich, um alle NULL- oder ungebundenen Werte zu 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 einen Wert von 2 in SOTargetsübergeben hat und der aktuelle Aufruf von SoSetTargets einen Wert übergibt. von 4 in SOTargets, der aktuelle Aufruf von SoSetTargets übergibt auch den Wert 0 im ClearTargets Parameter. Wenn der nächste aufeinander folgende Aufruf von SoSetTargets einen Wert von 1 in SOTargetsübergibt, übergibt der nachfolgende Aufruf auch den Wert 3 (4 - 1) in ClearTargets.
Der Treiber sollte keinen Fehler haben, mit Ausnahme von D3DDDIERR_DEVICEREMOVED. Wenn der Treiber daher einen Fehler außer D3DDDIERR_DEVICEREMOVED übergibt, bestimmt die Microsoft Direct3D-Laufzeit in einem Aufruf der pfnSetErrorCb-Funktion, dass der Fehler kritisch ist. Selbst wenn das Gerät entfernt wurde, ist der Treiber nicht erforderlich, um D3DDDIERR_DEVICEREMOVED zurückzugeben; Wenn die Geräteentfernung jedoch den Betrieb SOTargets beeinträchtigt (was normalerweise nicht geschehen sollte), kann der Treiber D3DDDIERR_DEVICEREMOVED zurückgeben.
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) |