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