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