DXGI_PRESENT
The DXGI_PRESENT constants specify options for presenting frames to the output.
| Constant/value | Description |
|---|---|
|
Present a frame from each buffer (starting with the current buffer) to the output. |
| DXGI_PRESENT_DO_NOT_SEQUENCE 0x00000002UL |
Present a frame from the current buffer to the output. Use this flag so that the presentation can use vertical-blank synchronization instead of sequencing buffers in the chain in the usual manner. Note: If the calling application sets the DXGI_PRESENT_DO_NOT_SEQUENCE constant on the first present operation (that is, when there is no current buffer), the runtime ignores that present operation and does not call the driver. |
|
Do not present the frame to the output. The status of the swap chain will be tested and appropriate errors returned. DXGI_PRESENT_TEST is intended for use only when switching from the idle state; do not use it to determine when to switch to the idle state because doing so can leave the swap chain unable to exit full-screen mode. |
|
Specifies that the runtime will discard outstanding queued presents. |
|
Specifies that the runtime will fail the presentation (that is, fail a call to IDXGISwapChain1::Present1) with the DXGI_ERROR_WAS_STILL_DRAWING error code if the calling thread is blocked; the runtime returns DXGI_ERROR_WAS_STILL_DRAWING instead of sleeping until the dependency is resolved. Direct3D 11: This enumeration value is supported starting with Windows 8. |
| DXGI_PRESENT_RESTRICT_TO_OUTPUT 0x00000010UL |
Indicates that presentation content will be shown only on the particular output. The content will not be visible on other outputs. For example, if the user tries to relocate video content on another output, the video content will not be visible. Direct3D 11: This enumeration value is supported starting with Windows 8. Note: This flag should only be used with swap effect DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL or DXGI_SWAP_EFFECT_FLIP_DISCARD. The use of this flag with other swap effects is being deprecated, and may not work in future versions of Windows. |
|
Indicates that if the stereo present must be reduced to mono, right-eye viewing is used rather than left-eye viewing. Direct3D 11: This enumeration value is supported starting with Windows 8. |
|
Indicates that the presentation should use the left buffer as a mono buffer. An application calls the IDXGISwapChain1::IsTemporaryMonoSupported method to determine whether a swap chain supports "temporary mono". Direct3D 11: This enumeration value is supported starting with Windows 8. |
| DXGI_PRESENT_USE_DURATION 0x00000100UL |
This flag must be set by media apps that are currently using a custom present duration (custom refresh rate). See IDXGISwapChainMedia. Note: This value is supported starting in Windows 8.1. |
|
Allowing tearing is a requirement of variable refresh rate displays. The conditions for using DXGI_PRESENT_ALLOW_TEARING during Present are as follows:
|
Remarks
Presentation options are supplied during the IDXGISwapChain::Present or IDXGISwapChain1::Present1 call. The buffers are specified in the swap chain description (see DXGI_SWAP_CHAIN_DESC or DXGI_SWAP_CHAIN_DESC1).
DXGI_PRESENT_RESTART is valid only for flip-model swap chains and full screen. Applications can use DXGI_PRESENT_RESTART to recover from glitches in playback, as well as to discard previously queued presentations. Discarding previously queued presentations is useful if those queued presentations are windowed scenarios. In particular, the previously queued presentation might have assumed that the window is an old size (that is, a resize operation occurred after submission).
DXGI_PRESENT_RESTRICT_TO_OUTPUT is valid only for swap chains that specified a particular output to restrict content to when those swap chains were created (IDXGIFactory2::CreateSwapChainForHwnd). If there is no output to restrict to, the flag is invalid.
DXGI_PRESENT_STEREO_PREFER_RIGHT indicates that if the stereo present must be reduced to mono the right eye should be used rather than the left (default) eye. You can use this flag if one side is higher quality (for example, if the stereo pair is synthesized from a standard image.)
DXGI_PRESENT_STEREO_TEMPORARY_MONO indicates that the present should use the left buffer as a mono buffer. You can use this flag to avoid updating the right buffer when an application temporarily has no stereo content. You should use this flag whenever possible because it enables significant optimization by the operating system and under some circumstances it can avoid visible mode change artifacts.
You should use the DXGI_PRESENT_STEREO_TEMPORARY_MONO flag in preference to switching to a mono swap chain for most applications that you anticipate will use stereo again. You need to balance the use of this flag in applications that are extremely long running or that rarely display stereo against the disadvantage of unused memory.
Note
Full-screen applications that switch to a mono swap chain cause a mode change that generally has visible artifacts (for example, "flashing”). However, temporary mono might not be supported for full-screen swap chains.
The DXGI_PRESENT_STEREO_PREFER_RIGHT and DXGI_PRESENT_STEREO_TEMPORARY_MONO flags apply only to stereo swap chains. If you use them when you present mono swap chains, an invalid operation occurs.
If you use the DXGI_PRESENT_STEREO_TEMPORARY_MONO flag when you present a stereo swap chain that does not support temporary mono, an error occurs, the swap chain does not display, and the presentation returns DXGI_ERROR_INVALID_CALL.
Requirements
| Requirement | Value |
|---|---|
| Header |
|
See also