Share via

Метод IDirect3DSwapChain9::GetFrontBufferData (d3d9helper.h)

  • Статья

Создает копию переднего буфера цепочки буферов буфера и помещает ее в системный буфер памяти, предоставляемый приложением.

Синтаксис

HRESULT GetFrontBufferData(
  [in, out] IDirect3DSurface9 *pDestSurface
);

Параметры

[in, out] pDestSurface

Тип: IDirect3DSurface9*

Указатель на интерфейс IDirect3DSurface9 , который получит копию буфера передней цепочки буфера. Данные возвращаются в последовательных строках без промежуточного пространства, начиная от вертикально верхней строки к самой низкой. Для оконного режима размер целевой поверхности должен быть размером рабочего стола. Для полноэкранного режима размер целевой поверхности должен быть размером экрана.

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

Тип: HRESULT

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

Комментарии

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

Требования

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

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

IDirect3DSwapChain9