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 Spüle, in die die Befehlsliste gestreamt wird.

Rückgabewert

Typ: HRESULT-

Wenn die Methode erfolgreich ist, wird S_OKzurückgegeben. Wenn ein Fehler auftritt, wird ein HRESULT- Fehlercode zurückgegeben.

Der Rückgabewert gibt alle Fehler an, die die Implementierung der Befehlssenke durch die EndDraw--Methode zurückgibt.

Bemerkungen

Die Befehlssenke kann von jedem Aufrufer der API implementiert werden.

Wenn der Aufrufer Entwurfszeitfehler aufruft, während eine Befehlsliste als Ziel ausgewählt ist, wird die Befehlsliste in einen Fehlerzustand versetzt. Der Streamanruf schlägt fehl, ohne anrufe an die übergebene Spüle 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

Siehe auch

ID2D1CommandList-