IDXGIOutput1::GetDisplaySurfaceData1 메서드(dxgi1_2.h)

디스플레이 표면(전면 버퍼)을 사용자가 제공한 리소스에 복사합니다.

구문

HRESULT GetDisplaySurfaceData1(
  [in] IDXGIResource *pDestination
);

매개 변수

[in] pDestination

GetDisplaySurfaceData1이 표시 화면을 복사하는 리소스를 나타내는 리소스 인터페이스에 대한 포인터입니다.

반환 값

DXGI_ERROR 항목에 설명된 오류 코드 중 하나를 반환합니다.

설명

GetDisplaySurfaceData1 은 IDXGIOutput::GetDisplaySurfaceData 와 비슷하지만 GetDisplaySurfaceData1 은 IDXGIResource 를 사용하고 IDXGIOutput::GetDisplaySurfaceData 는 IDXGISurface를 사용합니다.

GetDisplaySurfaceData1은 입력 리소스가 스왑 체인 버퍼와 동일한 배열 크기(D3D11_TEXTURE2D_DESC 구조체의 ArraySize 멤버)가 있는 2D 텍스처(ID3D11Texture2D 인터페이스로 표현됨)가 아닌 경우 오류를 반환합니다.

원래 IDXGIOutput::GetDisplaySurfaceData 및 업데이트된 GetDisplaySurfaceData1 은 정확히 동일하게 작동합니다. 배열 크기가 2(ArraySize = 2)인 텍스처가 IDXGISurface를 구현하지 않으므로 GetDisplaySurfaceData1이 필요했습니다.

출력이 전체 화면 모드인 경우에만 GetDisplaySurfaceData1 을 호출할 수 있습니다. GetDisplaySurfaceData1이 성공하면 대상 리소스를 채웁니다.

대상 리소스에 대한 공간을 할당하려는 경우 IDXGIOutput::GetDesc 를 사용하여 출력의 크기(너비 및 높이)를 결정합니다. 이는 대상 모니터 회전에 관계없이 마찬가지입니다. 그래픽 구성 요소(예: Direct3D 11)에서 만든 대상 리소스는 CPU 쓰기 권한으로 만들어야 합니다( D3D11_CPU_ACCESS_WRITE 참조). CPU 읽기-쓰기 권한(D3D11_CPU_ACCESS_READ D3D11_CPU_ACCESS_WRITE | )을 사용하여 다른 표면을 만들 수 있습니다. GetDisplaySurfaceData1 은 대상 리소스에 맞게 표면 데이터를 수정합니다(스트레치, 축소, 형식 변환, 회전). GetDisplaySurfaceData1 은 점 샘플링을 사용하여 스트레치 및 축소를 수행합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2용 Windows Server 2012 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	dxgi1_2.h
라이브러리	DXGI.lib

추가 정보

IDXGIOutput1