Share via


IDirect3DSwapChain9::GetFrontBufferData 메서드(d3d9helper.h)

스왑 체인의 프런트 버퍼 복사본을 생성하고 애플리케이션에서 제공하는 시스템 메모리 버퍼에 복사하는 위치를 지정합니다.

구문

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

매개 변수

[in, out] pDestSurface

형식: IDirect3DSurface9*

스왑 체인의 전면 버퍼 복사본을 받을 IDirect3DSurface9 인터페이스에 대한 포인터입니다. 데이터는 세로로 가장 높은 행에서 가장 낮은 행으로 시작하여 중간 공간이 없는 연속 행으로 반환됩니다. 창 모드의 경우 대상 표면의 크기는 데스크톱의 크기여야 합니다. 전체 화면 모드의 경우 대상 화면의 크기는 화면 크기여야 합니다.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. BackBuffer가 총 백 버퍼 수를 초과하거나 같으면 함수가 실패하고 D3DERR_INVALIDCALL 반환합니다.

설명

이 메서드를 호출하면 IDirect3DSurface9 인터페이스의 내부 참조 수가 증가합니다. 이 IDirect3DSurface9 인터페이스 사용을 마쳤을 때 IUnknown::Release를 호출하지 않으면 메모리 누수가 발생합니다.

요구 사항

요구 사항
대상 플랫폼 Windows
헤더 d3d9helper.h(D3D9.h 포함)
라이브러리 D3D9.lib

추가 정보

IDirect3DSwapChain9