ID2D1CommandList::Stream-Methode (d2d1_1.h)
Streamt den Inhalt der Befehlsliste an die angegebene Befehlssenke.
Syntax
HRESULT Stream(
[in] ID2D1CommandSink *sink
);
Parameter
[in] sink
Typ: ID2D1CommandSink*
Die Senke, in die die Befehlsliste gestreamt wird.
Rückgabewert
Typ: HRESULT
Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Wenn ein Fehler auftritt, wird ein HRESULT-Fehlercode zurückgegeben.
Der Rückgabewert gibt alle Fehler an, die die Befehlssenkeimplementierung über die EndDraw-Methode zurückgibt.
Hinweise
Die Befehlssenke kann von jedem Aufrufer der API implementiert werden.
Wenn der Aufrufer Fehleraufrufe zur Entwurfszeit durchführt, während eine Befehlsliste als Ziel ausgewählt ist, wird die Befehlsliste in einen Fehlerzustand versetzt. Der Streamaufruf schlägt fehl, ohne anrufe an die übergebene Senke zu tätigen.
Beispielverwendung:
Class MyCommandSink : public ID2D1CommandSink
{
public:
// All of the ID2D1CommandSink methods implemented here.
};
HRESULT
StreamToMyCommandSink(
__in ID2D1CommandList *pCommandList
)
{
HRESULT hr = S_OK;
MyCommandSink *pCommandSink = new MyCommandSink();
hr = pCommandSink ? S_OK : E_OUTOFMEMORY;
if (SUCCEEDED(hr))
{
// Receive the contents of the command sink streamed to the sink.
hr = pCommandList->Stream(pCommandSink);
}
SafeRelease(&pCommandSink);
return hr;
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | d2d1_1.h |
| DLL | D2d1.dll |