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 |