Метод IDirect3DDevice9::GetRenderTargetData (d3d9helper.h)

  • Статья

Копирует данные целевой отрисовки из памяти устройства в системную память.

Синтаксис

HRESULT GetRenderTargetData(
  [in] IDirect3DSurface9 *pRenderTarget,
  [in] IDirect3DSurface9 *pDestSurface
);

Параметры

[in] pRenderTarget

Тип: IDirect3DSurface9*

Указатель на объект IDirect3DSurface9 , представляющий целевой объект отрисовки.

[in] pDestSurface

Тип: IDirect3DSurface9*

Указатель на объект IDirect3DSurface9 , представляющий целевую поверхность.

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

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет D3D_OK. В случае сбоя метода возвращается одно из следующих значений: D3DERR_DRIVERINTERNALERROR, D3DERR_DEVICELOST D3DERR_INVALIDCALL.

Комментарии

Целевая поверхность должна быть либо открытой поверхностью вне экрана, либо уровнем текстуры (MIP-карты или текстуры куба), созданной с помощью D3DPOOL_SYSTEMMEM.

Исходная поверхность должна быть обычным целевым объектом отрисовки или уровнем текстуры целевой отрисовки (MIP-карты или текстуры куба), созданной с помощью POOL_DEFAULT.

Этот метод завершится ошибкой, если:

  • Целевой объект отрисовки является несколькими выборками.
  • Исходный целевой объект отрисовки отличается от размера целевой поверхности.
  • Форматы целевой и целевой поверхностей отрисовки источника не совпадают.

Требования

Требование Значение
Целевая платформа Windows
Header d3d9helper.h (включая D3D9.h)
Библиотека D3D9.lib

См. также раздел

IDirect3DDevice9