Метод 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