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

Статья
03/05/2024

Извлекает поверхность целевого объекта отрисовки.

Синтаксис

HRESULT GetRenderTarget(
  [in]  DWORD             RenderTargetIndex,
  [out] IDirect3DSurface9 **ppRenderTarget
);

Параметры

[in] RenderTargetIndex

Тип: DWORD

Индекс целевого объекта отрисовки. См. заметки.

[out] ppRenderTarget

Тип: IDirect3DSurface9**

Адрес указателя на интерфейс IDirect3DSurface9 , представляющий возвращенную целевую поверхность отрисовки для этого устройства.

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

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет D3D_OK. Если метод завершается сбоем, возвращаемое значение можно D3DERR_INVALIDCALL, если один из аргументов является недопустимым, или D3DERR_NOTFOUND, если для заданного индекса нет доступного целевого объекта отрисовки.

Как правило, методы, возвращающие состояние, не работают на устройстве, созданном с помощью D3DCREATE_PUREDEVICE. Однако этот метод будет работать даже на чистом устройстве, так как он возвращает интерфейс.

Теперь устройство может поддерживать несколько целевых объектов отрисовки. Количество целевых объектов отрисовки, поддерживаемых устройством, содержится в элементе NumSimultaneousRTs D3DCAPS9. См. раздел Несколько целевых объектов отрисовки (Direct3D 9).

Вызов этого метода увеличит количество внутренних ссылок в интерфейсе IDirect3DSurface9 . Сбой вызова IUnknown::Release после завершения использования интерфейса IDirect3DSurface9 приводит к утечке памяти.

Требования

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

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

IDirect3DDevice9

IDirect3DDevice9::SetRenderTarget

Share via