IDirect3DSwapChain9：：GetFrontBufferData 方法 (d3d9helper.h)

產生交換鏈前端緩衝區的複本，並將該復本放在應用程式所提供的系統記憶體緩衝區中。

語法

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

[in, out] pDestSurface

IDirect3DSurface9 介面的指標，該介面將接收交換鏈前端緩衝區的複本。數據會以連續的數據列傳回，沒有交錯空間，從垂直最高數據列到最低。如果是視窗模式，目的地介面的大小應該是桌面的大小。針對全螢幕模式，目的地介面的大小應該是螢幕大小。

類型： HRESULT

如果方法成功，傳回值會D3D_OK。如果BackBuffer超過或等於後端緩衝區的總數，函式會失敗並傳回D3DERR_INVALIDCALL。

呼叫這個方法將會增加 IDirect3DSurface9 介面上的內部參考計數。使用此 IDirect3DSurface9 介面完成時，無法呼叫 IUnknown：：Release 會導致記憶體流失。