ID2D1CommandList::Stream-Methode (d2d1_1.h)

  • Artikel

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

Weitere Informationen

ID2D1CommandList