Метод IDirect3DSwapChain9::GetFrontBufferData (d3d9.h)
Создает копию переднего буфера цепочки буферов буфера и помещает ее в системный буфер памяти, предоставляемый приложением.
Синтаксис
HRESULT GetFrontBufferData(
[in, out] IDirect3DSurface9 *pDestSurface
);
Параметры
[in, out] pDestSurface
Тип: IDirect3DSurface9*
Указатель на интерфейс IDirect3DSurface9 , который получит копию буфера передней цепочки буфера. Данные возвращаются в последовательных строках без промежуточного пространства, начиная от вертикально верхней строки к самой низкой. Для оконного режима размер целевой поверхности должен быть размером рабочего стола. Для полноэкранного режима размер целевой поверхности должен быть размером экрана.
Возвращаемое значение
Тип: HRESULT
Если метод выполнен успешно, возвращаемое значение будет D3D_OK. Если Значение BackBuffer превышает или равно общему количеству задних буферов, функция завершается сбоем и возвращает D3DERR_INVALIDCALL.
Комментарии
Вызов этого метода увеличит количество внутренних ссылок в интерфейсе IDirect3DSurface9 . Сбой вызова IUnknown::Release после завершения использования этого интерфейса IDirect3DSurface9 приводит к утечке памяти.
Требования
Целевая платформа | Windows |
Header | d3d9.h (включая D3D9.h) |
Библиотека | D3D9.lib |