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

Статья
08/23/2023

Извлекает задний буфер из цепочки буферов устройства.

Синтаксис

HRESULT GetBackBuffer(
  [in]          UINT               iSwapChain,
  [in]          UINT               iBackBuffer,
  [in]          D3DBACKBUFFER_TYPE Type,
  [out, retval] IDirect3DSurface9  **ppBackBuffer
);

Параметры

[in] iSwapChain

Тип: UINT

Целое число без знака, задающее цепочку буферов.

[in] iBackBuffer

Тип: UINT

Индекс возвращаемого объекта обратного буфера. Задние буферы нумеруются от 0 до общего числа задних буферов минус один. Значение 0 возвращает первый задний буфер, а не передний буфер. Передний буфер недоступен с помощью этого метода. Используйте IDirect3DDevice9::GetFrontBufferData , чтобы получить копию переднего буфера.

[in] Type

Тип: D3DBACKBUFFER_TYPE

Стерео представление не поддерживается в Direct3D 9, поэтому единственным допустимым значением этого параметра является D3DBACKBUFFER_TYPE_MONO.

[out, retval] ppBackBuffer

Тип: IDirect3DSurface9**

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

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

Тип: HRESULT

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

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

Требования


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

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

IDirect3DDevice9

IDirect3DDevice9::GetFrontBufferData