Share via

Метод IDirect3DDevice9::GetRenderTargetData (d3d9.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 d3d9.h (включая D3D9.h)
Библиотека D3D9.lib

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

IDirect3DDevice9