Метод IDirect3DDevice9::GetRenderTarget (d3d9.h)
Извлекает поверхность целевого объекта отрисовки.
Синтаксис
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 | d3d9.h (включая D3D9.h) |
| Библиотека | D3D9.lib |