DirectX Graphics 레퍼런스 Direct3D C/C++ 레퍼런스 인터페이스 IDirect3DSwapChain9 GetFrontBufferData [목차열람] [주소복사] [슬롯비우기] |
Microsoft DirectX 9.0 |
스왑 체인의 프론트 버퍼의 복사를 생성해, 애플리케이션이 제공하는 시스템 메모리 버퍼에 그 복사를 저장 한다.
구문
HRESULT GetFrontBufferData(
IDirect3DSurface9 *pDestSurface );
파라미터
- pDestSurface
- [in, out] IDirect3DSurface9 인터페이스의 포인터. 스왑 체인의 프론트 버퍼의 복사를 받는다. 데이터는, 맨 위의 행으로부터 시작해 맨 밑의 행까지, 사이에 스페이스를 사이에 두지 않는 연속한 행으로 반환된다. 윈도우 모드의 경우, 목적지 표면의 사이즈는, 데스크탑의 사이즈가 아니면 안된다. 풀 스크린 모드의 경우, 목적지 표면의 사이즈는, 스크린의 사이즈가 아니면 안된다.
반환값
성공했을 경우는,D3D_OK 를 돌려준다.
BackBuffer 가 백 버퍼의 총수 이상의 경우, 함수는 실패해,D3DERR_INVALIDCALL 를 돌려준다.
주의
이 메서드를 호출하면,IDirect3DSurface9 인터페이스에 대한 내부 참조 카운트가 증가한다. 이 IDirect3DSurface9 인터페이스의 사용을 종료했을 때에 IUnknown::Release 를 호출하지 않으면 메모리 누수가 발생한다.