共用方式為

DXGI_PRESENT

  • 發行項

DXGI_PRESENT常數會指定將畫面呈現至輸出的選項。

常數/值 描述
0
 從目前緩衝區) 開始，從每個緩衝區呈現畫面 (到輸出。
DXGI_PRESENT_DO_NOT_SEQUENCE
0x00000002UL
 將框架從目前緩衝區呈現至輸出。 使用此旗標，讓簡報可以使用垂直空白同步處理，而不是以一般方式排序鏈結中的緩衝區。
注意： 如果呼叫的應用程式在第一個目前 (作業上設定DXGI_PRESENT_DO_NOT_SEQUENCE常數，也就是沒有目前的緩衝區) 時，執行時間會忽略該存在的作業，而且不會呼叫驅動程式。
DXGI_PRESENT_TEST
0x00000001UL
 請勿將框架呈現至輸出。 交換鏈結的狀態將會經過測試，並傳回適當的錯誤。 DXGI_PRESENT_TEST僅適用于從閒置狀態切換時使用;請勿使用它來判斷何時切換至閒置狀態，因為這樣做可能會讓交換鏈結無法結束全螢幕模式。
DXGI_PRESENT_RESTART
0x00000004UL
 指定執行時間會捨棄未處理的佇列呈現。
DXGI_PRESENT_DO_NOT_WAIT
0x000000008UL
 指定執行時間會失敗簡報 (，也就是說，如果封鎖呼叫執行緒，則呼叫 IDXGISwapChain1：:P resent1) 失敗，並出現 DXGI_ERROR_WAS_STILL_DRAWING 錯誤碼;執行時間會傳回DXGI_ERROR_WAS_STILL_DRAWING，而不是睡眠，直到解析相依性為止。
Direct3D 11： 從 Windows 8 開始，支援此列舉值。
DXGI_PRESENT_RESTRICT_TO_OUTPUT
0x00000010UL
 表示只在特定輸出上顯示簡報內容。 其他輸出上將不會顯示內容。 例如，如果使用者嘗試在另一個輸出上重新放置視訊內容，則不會顯示影片內容。
Direct3D 11： 從 Windows 8 開始，支援此列舉值。
注意： 此旗標應該只用于交換效果 DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL 或DXGI_SWAP_EFFECT_FLIP_DISCARD。 此旗 標與其他交換 效果的用法已被取代，且可能無法在未來的 Windows 版本中運作。
DXGI_PRESENT_STEREO_PREFER_RIGHT
0x00000020UL
 指出如果立體呈現必須縮減為單聲道，則會使用右眼檢視，而不是左眼檢視。
Direct3D 11： 從 Windows 8 開始，支援此列舉值。
DXGI_PRESENT_STEREO_TEMPORARY_MONO
0x00000040UL
 表示簡報應該使用左緩衝區做為單一緩衝區。 應用程式會呼叫 IDXGISwapChain1：：IsTemporaryMonoSupported 方法，以判斷交換鏈結是否支援「暫存 mono」。
Direct3D 11： 從 Windows 8 開始，支援此列舉值。
DXGI_PRESENT_USE_DURATION
0x00000100UL
 此旗標必須由目前使用自訂目前持續時間的媒體應用程式設定， (自訂重新整理率) 。 請參閱 IDXGISwapChainMedia。
注意：從 Windows 8.1 開始支援此值。
DXGI_PRESENT_ALLOW_TEARING
0x00000200UL
 允許卸載是可變重新整理速率顯示的需求。
在 Present 期間使用DXGI_PRESENT_ALLOW_TEARING的條件如下：
  • 交換鏈結必須使用 DXGI_SWAP_CHAIN_FLAG_ALLOW_TEARING 旗標來建立。
  • 傳入至 Present (或Present1) 的同步間隔必須是 0。
  • DXGI_PRESENT_ALLOW_TEARING旗標不能用於目前處於全螢幕獨佔模式的應用程式， (呼叫 SetFullscreenState (TRUE) ) 。 它只能在視窗模式中使用。 若要在全螢幕 Win32 應用程式中使用此旗標，應用程式應該會顯示至全螢幕無框線視窗，並使用 IDXGIFactory：：MakeWindowAssociation停用自動 ALT+ENTER 全螢幕切換。 透過呼叫 Windows::UI::ViewManagement::ApplicationView::TryEnterFullscreen() 進入全螢幕模式的 UWP 應用程式是全螢幕無框線視窗，而且可以使用 旗標。
使用此旗標呼叫 Present (或Present1) ，但不符合上述條件，將會導致DXGI_ERROR_INVALID_CALL錯誤傳回給呼叫應用程式。

備註

簡報選項會在 IDXGISwapChain：:P resent 或 IDXGISwapChain1：:P resent1 呼叫期間提供。 緩衝區是在交換鏈結描述中指定， (請參閱 DXGI_SWAP_CHAIN_DESC 或 DXGI_SWAP_CHAIN_DESC1) 。

DXGI_PRESENT_RESTART僅適用于翻轉模型交換鏈結和全螢幕。 應用程式可以使用DXGI_PRESENT_RESTART從播放中的問題復原，以及捨棄先前排入佇列的簡報。 如果這些已排入佇列的簡報是視窗式案例，捨棄先前已排入佇列的簡報會很有用。 特別是，先前排入佇列的簡報可能假設視窗是舊大小 (，也就是提交) 之後發生調整大小作業。

DXGI_PRESENT_RESTRICT_TO_OUTPUT僅適用于指定特定輸出的交換鏈結，以在 IDXGIFactory2：：CreateSwapChainForHwnd) 建立這些交換 (鏈結時限制內容。 如果沒有輸出限制為 ，則旗標無效。

DXGI_PRESENT_STEREO_PREFER_RIGHT表示如果必須縮小為單聲道，則應該使用右眼，而不是左 (預設) 眼。 例如，如果一端品質較高， (，則可以使用此旗標，例如，如果立體體配對是從標準影像合成。)

DXGI_PRESENT_STEREO_TEMPORARY_MONO表示目前應該使用左緩衝區做為單一緩衝區。 當應用程式暫時沒有立體內容時，您可以使用此旗標來避免更新正確的緩衝區。 您應該盡可能使用此旗標，因為它會啟用作業系統的重大優化，在某些情況下，它可能會避免可見模式變更成品。

您應該使用喜好設定DXGI_PRESENT_STEREO_TEMPORARY_MONO旗標，針對您預期會再次使用立體化的大部分應用程式切換至單聲道交換鏈結。 您必須平衡在長時間執行的應用程式中使用這個旗標，或很少針對未使用記憶體的缺點顯示立體化。

注意

切換至單色交換鏈結的全螢幕應用程式會導致模式變更，通常有可見成品 (例如「閃爍」) 。 不過，全螢幕交換鏈結可能不支援暫存單聲道。

 

DXGI_PRESENT_STEREO_PREFER_RIGHT和DXGI_PRESENT_STEREO_TEMPORARY_MONO旗標僅適用于立體交換鏈結。 如果您在呈現單色交換鏈結時使用這些連結鏈結，就會發生不正確作業。

如果您在呈現不支援暫存單聲道的立體交換鏈結時使用DXGI_PRESENT_STEREO_TEMPORARY_MONO旗標，就會發生錯誤、交換鏈結不會顯示，而且簡報會傳回 DXGI_ERROR_INVALID_CALL。

規格需求

需求 值
標頭
DXGI.h

另請參閱

DXGI 常數