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 |