ID2D1CommandList::Stream メソッド (d2d1_1.h)

コマンド リストの内容を、指定したコマンド シンクにストリーミングします。

構文

HRESULT Stream(
  [in] ID2D1CommandSink *sink
);

パラメーター

[in] sink

種類: ID2D1CommandSink*

コマンド リストのストリーミング先となるシンク。

戻り値

型: HRESULT

メソッドが成功すると、 S_OKが返されます。 失敗した場合は、 HRESULT エラー コードが返されます。

戻り値は、コマンド シンク実装が EndDraw メソッドを通じて返すエラーを示します。

注釈

コマンド シンクは、API の任意の呼び出し元によって実装できます。

コマンド リストがターゲットとして選択されている間に、呼び出し元がデザイン時のエラー呼び出しを行うと、コマンド リストはエラー状態になります。 ストリーム呼び出しは、シンクで渡された への呼び出しを行わずに失敗します。

使用例:

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;

}

要件

こちらもご覧ください

ID2D1CommandList