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

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

구문

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

매개 변수

[in] iBackBuffer

형식: UINT

반환할 백 버퍼 개체의 인덱스입니다. 백 버퍼는 0부터 총 백 버퍼 수(1)로 번호가 매겨집니다. 값 0은 앞면 버퍼가 아닌 첫 번째 백 버퍼를 반환합니다. 이 메서드를 통해 프런트 버퍼에 액세스할 수 없습니다. IDirect3DSwapChain9::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를 호출하지 못하면 메모리 누수가 발생합니다. 속한 스왑 체인을 해제하기 전에 이 메서드를 통해 얻은 표면을 해제해야 합니다.

요구 사항

추가 정보

IDirect3DSwapChain9

IDirect3DSwapChain9::GetFrontBufferData