Метод IDirect3DDevice9::P resent (d3d9.h)

Статья
08/23/2023

Представляет содержимое следующего буфера в последовательности задних буферов, принадлежащих устройству.

Синтаксис

HRESULT Present(
  [in] const RECT    *pSourceRect,
  [in] const RECT    *pDestRect,
  [in] HWND          hDestWindowOverride,
  [in] const RGNDATA *pDirtyRegion
);

Параметры

[in] pSourceRect

Тип: const RECT*

Указатель на значение, которое должно иметь значение NULL , если только цепочка буферов не была создана с помощью D3DSWAPEFFECT_COPY. pSourceRect — это указатель на структуру RECT , содержащую исходный прямоугольник. Если значение РАВНО NULL, отображается вся исходная поверхность. Если прямоугольник превышает исходную поверхность, прямоугольник обрезается к исходной поверхности.

[in] pDestRect

Тип: const RECT*

Указатель на значение, которое должно иметь значение NULL , если только цепочка буферов не была создана с помощью D3DSWAPEFFECT_COPY. pDestRect — это указатель на структуру RECT , содержащую прямоугольник назначения в координатах клиента окна. Если значение РАВНО NULL, заполняется вся клиентская область. Если прямоугольник превышает целевую клиентную область, прямоугольник обрезается к целевой клиентской области.

[in] hDestWindowOverride

Тип: HWND

Указатель на целевое окно, клиентская область которого принимается в качестве целевого объекта для этой презентации. Если это значение равно NULL, среда выполнения использует элемент hDeviceWindowD3DPRESENT_PARAMETERS для презентации.

[in] pDirtyRegion

Тип: const RGNDATA*

Значение должно иметь значение NULL , если только цепочка буферов не была создана с D3DSWAPEFFECT_COPY. Дополнительные сведения о цепочках буферов см. в разделах Flipping Surfaces (Direct3D 9) и D3DSWAPEFFECT. Если это значение не равно NULL, автономная область выражается в координатах обратного буфера. Прямоугольники в области представляют собой минимальный набор пикселей, которые необходимо обновить. Этот метод учитывает эти прямоугольники при оптимизации представления путем копирования только пикселей в пределах области или некоторых подходящих расширенных наборов прямоугольников. Это помогает только для оптимизации, и приложение не должно полагаться на точно копируемый регион. Реализация может скопировать весь исходный прямоугольник.

Возвращаемое значение

Тип: HRESULT

Возможные возвращаемые значения: D3D_OK или D3DERR_DEVICEREMOVED (см. раздел D3DERR).

При вызове между парами BeginScene и EndScene произойдет сбой, возвращая D3DERR_INVALIDCALL, если целевой объект отрисовки не является текущим целевым объектом отрисовки (например, задним буфером, который вы получаете при создании дополнительной цепочки буферов). Это новое поведение для Direct3D 9.