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

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

구문

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

[in] iSwapChain

형식: UINT

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

[in] pDestSurface

프런트 버퍼의 콘텐츠 복사본을 받을 IDirect3DSurface9 인터페이스에 대한 포인터입니다. 데이터는 디바이스 출력에서 세로로 가장 높은 행에서 가장 낮은 행으로 시작하여 중간 공간이 없는 연속 행으로 반환됩니다.

창 모드의 경우 대상 표면의 크기는 데스크톱의 크기여야 합니다. 전체 화면 모드의 경우 대상 화면의 크기는 화면 크기여야 합니다.

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 반환 값은 D3DERR_DRIVERINTERNALERROR, D3DERR_DEVICELOST, D3DERR_INVALIDCALL 중 하나일 수 있습니다.

pDestSurface가 가리키는 버퍼는 D3DFMT_A8R8G8B8 픽셀 형식당 표준 32비트로 변환된 전면 버퍼의 표현으로 채워집니다.

이 방법은 앤티앨리어스 스크린샷을 캡처하는 유일한 방법입니다.

이 함수는 의도적으로 매우 느리며 성능에 중요한 경로에서 사용하면 안 됩니다.