IDirect3DSwapChain9：：GetFrontBufferData 方法 (d3d9.h)

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

語法

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

[in, out] pDestSurface

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

類型： HRESULT

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

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