IDirect3DDevice9::GetBackBuffer 메서드(d3d9helper.h)

디바이스의 스왑 체인에서 백 버퍼를 검색합니다.

구문

HRESULT GetBackBuffer(
  [in]          UINT               iSwapChain,
  [in]          UINT               iBackBuffer,
  [in]          D3DBACKBUFFER_TYPE Type,
  [out, retval] IDirect3DSurface9  **ppBackBuffer
);

매개 변수

[in] iSwapChain

형식: UINT

스왑 체인을 지정하는 부호 없는 정수입니다.

[in] iBackBuffer

형식: UINT

반환할 백 버퍼 개체의 인덱스입니다. 백 버퍼의 번호는 0에서 백 버퍼의 총 수에서 1을 뺀 값으로 번호가 매겨집니다. 값 0은 앞면 버퍼가 아닌 첫 번째 백 버퍼를 반환합니다. 이 메서드를 통해 프런트 버퍼에 액세스할 수 없습니다. IDirect3DDevice9::GetFrontBufferData를 사용하여 프런트 버퍼의 복사본을 검색합니다.

[in] Type

형식: D3DBACKBUFFER_TYPE

Direct3D 9에서는 스테레오 보기가 지원되지 않으므로 이 매개 변수에 유효한 값만 D3DBACKBUFFER_TYPE_MONO.

[out, retval] ppBackBuffer

형식: IDirect3DSurface9**

반환된 백 버퍼 표면을 나타내는 IDirect3DSurface9 인터페이스에 대한 포인터의 주소입니다.

반환 값

형식: HRESULT

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

설명

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

요구 사항

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

추가 정보

IDirect3DDevice9

IDirect3DDevice9::GetFrontBufferData