共用方式為


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 來調整目標視窗的大小 (,而不是 Microsoft Win32API,例如 SetWindowPos) ,而不需要知道交換鏈結顯示模式。

如果 Windows 市集應用程式呼叫 ResizeTarget,它會因為 DXGI_ERROR_NOT_CURRENTLY_AVAILABLE而失敗。

您無法在以IDXGIFactory2::CreateSwapChainForComposition 建立的交換鏈結上呼叫 ResizeTarget

應用程式在呼叫 ResizeTarget 之後,仍然必須呼叫 IDXGISwapChain::ResizeBuffers,因為只有 ResizeBuffers 可以變更後台緩衝區。 但是,如果這些應用程式已實作視窗重設大小處理來呼叫 ResizeBuffers,則不需要在呼叫 ResizeTarget 之後明確呼叫 ResizeBuffer,因為視窗重設大小處理將會達到應用程式所需的專案。

規格需求

需求
目標平台 Windows
標頭 dxgi.h
程式庫 DXGI.lib

另請參閱

IDXGISwapChain