IDXGISwapChain::ResizeTarget 메서드(dxgi.h)

출력 대상의 크기를 조정합니다.

구문

HRESULT ResizeTarget(
  [in] const DXGI_MODE_DESC *pNewTargetParameters
);

매개 변수

[in] pNewTargetParameters

형식: const DXGI_MODE_DESC*

대상의 새 너비, 높이, 형식 및 새로 고침 속도를 지정하는 모드를 설명하는 DXGI_MODE_DESC 구조체에 대한 포인터입니다. 형식이 DXGI_FORMAT_UNKNOWN 경우 ResizeTarget 은 기존 형식을 사용합니다. 이 메서드는 스레드로부터 안전하지 않으므로 스왑 체인이 전체 화면 모드인 경우에만 DXGI_FORMAT_UNKNOWN 사용하는 것이 좋습니다.

반환 값

형식: HRESULT

성공 또는 실패를 나타내는 코드를 반환합니다. 이 API가 호출될 때 전체 화면/창 모드 전환이 발생하는 경우 DXGI_STATUS_MODE_CHANGE_IN_PROGRESS 반환됩니다. 추가 DXGI 오류 코드는 DXGI_ERROR 참조하세요.

설명

ResizeTarget 은 스왑 체인이 창 모드에 있을 때 대상 창의 크기를 조정하고 스왑 체인이 전체 화면 모드일 때 대상 출력의 표시 모드를 변경합니다. 따라서 앱은 ResizeTarget 을 호출하여 스왑 체인 표시 모드에 대한 지식 없이 대상 창( SetWindowPos와 같은 Microsoft Win32API 대신)의 크기를 조정할 수 있습니다.

Windows 스토어 앱이 ResizeTarget을 호출하면 DXGI_ERROR_NOT_CURRENTLY_AVAILABLE 실패합니다.

IDXGIFactory2::CreateSwapChainForComposition으로 만든 스왑 체인에서는 ResizeTarget을 호출할 수 없습니다.

ResizeBuffers만 백 버퍼를 변경할 수 있으므로 앱은 ResizeTarget을 호출한 후에도 IDXGISwapChain::ResizeBuffers를 호출해야 합니다. 그러나 해당 앱이 ResizeBuffers를 호출하기 위해 창 크기 조정 처리를 구현한 경우 창 크기 조정 처리가 앱에 필요한 것을 달성하기 때문에 ResizeTarget을 호출한 후 ResizeBuffers를 명시적으로 호출할 필요가 없습니다.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	dxgi.h
라이브러리	DXGI.lib

추가 정보

IDXGISwapChain