ID3D10Device::SOSetTargets-Methode (d3d10.h)
Legen Sie die Zielausgabepuffer für die StreamOutput-Phase fest, wodurch die Pipeline zum Streamen von Daten aktiviert/deaktiviert wird.
Syntax
void SOSetTargets(
[in] UINT NumBuffers,
[in] ID3D10Buffer * const *ppSOTargets,
[in] const UINT *pOffsets
);
Parameter
[in] NumBuffers
Typ: UINT
Die Anzahl des Puffers, der an das Gerät gebunden werden soll. Es können maximal vier Ausgabepuffer festgelegt werden. Wenn weniger als vier durch den Aufruf definiert werden, werden die verbleibenden Pufferslots auf NULL festgelegt. Siehe Hinweise.
[in] ppSOTargets
Typ: ID3D10Buffer*
Das Array von Ausgabepuffern (siehe ID3D10Buffer), das an das Gerät gebunden werden soll. Die Puffer müssen mit dem flag D3D10_BIND_STREAM_OUTPUT erstellt worden sein.
[in] pOffsets
Typ: const UINT*
Array von Offsets zu den Ausgabepuffern von ppSOTargets, ein Offset für jeden Puffer. Die Offsetwerte müssen in Bytes angegeben werden.
Rückgabewert
Keine
Bemerkungen
Rufen Sie ID3D10Device::SOSetTargets (vor allen Draw-Aufrufen) auf, um Daten zu streamen. rufen Sie SOSetTargets mit NULL auf, um das Streamen von Daten zu beenden. Ein Beispiel finden Sie unter Übung 01 aus dem GDC 2007-Workshop, in der die Rendertargets der Streamausgabe vor dem Aufruf von Draw-Methoden in der RenderInstanceToStream-Funktion festgelegt werden.
Ein Offset von -1 bewirkt, dass der Streamausgabepuffer angefügt wird und nach dem letzten Speicherort, der in einem vorherigen Streamausgabedurchlauf in den Puffer geschrieben wurde, fortgesetzt wird.
Wenn Sie diese Methode mithilfe eines Puffers aufrufen, der derzeit für das Schreiben gebunden ist, wird stattdessen effektiv NULL gebunden, da ein Puffer nicht gleichzeitig als Eingabe und Ausgabe gebunden werden kann.
Die Debugebene generiert immer dann eine Warnung, wenn verhindert wird, dass eine Ressource gleichzeitig als Eingabe und Ausgabe gebunden wird. Dadurch wird jedoch nicht verhindert, dass ungültige Daten von der Laufzeit verwendet werden.
Die -Methode enthält keinen Verweis auf die übergebenen Schnittstellen. Aus diesem Grund sollten Anwendungen darauf achten, keine Schnittstelle freizugeben, die derzeit vom Gerät verwendet wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | d3d10.h |
| Bibliothek | D3D10.lib |