Export (0) Print
Expand All

D3DPRESENT

Describes the relationship between the adapter refresh rate and the rate at which Present or Present operations are completed. These values also serve as flag values for the PresentationIntervals field of D3DCAPS9.

ConstantDescription
D3DPRESENT_DONOTFLIP

Use the front buffer as both the source and target surface during rendering. A frame synch is scheduled but the displayed surface does not change. This flag is only available when the application is in fullscreen mode and D3DSWAPEFFECT_FLIPEX has been specified.

This flag is available in Direct3D 9Ex only.

D3DPRESENT_DONOTWAIT

A presentation cannot be scheduled by a hal device. If this flag is set in a call to Present, and the hardware is busy processing or waiting for a vertical sync interval, then Present will return D3DERR_WASSTILLDRAWING to indicate that the blit operation is incomplete.

D3DPRESENT_FLIPRESTART

Reserved.

D3DPRESENT_FORCEIMMEDIATE

D3DPRESENT_INTERVAL_IMMEDIATE is enforced on this Present call. This flag can only be specified when using D3DSWAPEFFECT_FLIPEX. Windowed and fullscreen presentation behaviors are the same. This is especially useful for media apps that want to discard frames that have been detected as late and present subsequent frames at composition time. An invalid parameter error will be returned if this flag is improperly specified. When multiple consecutive frames with D3DPRESENT_FORCEIMMEDIATEs are queued, only the last frame is displayed, for both windowed and fullscreen presentation. A sample application that uses D3DPRESENT_FORCEIMMEDIATE and D3DSWAPEFFECT_FLIPEX is the D3D9ExFlipEx sample on the MSDN Code Gallery.

This flag is available in Direct3D 9Ex on Windows 7 or later operating systems.

When using D3DSWAPEFFECT_FLIPEX, each frame presented using D3DPRESENT_INTERVAL_IMMEDIATE or D3DPRESENT_INTERVAL_FORCEIMMEDIATE will override the previous frame's present interval. For example, if you queue the following frames using the following swap effects: frame A (D3DPRESENT_INTERVAL_ONE), frame B(D3DPRESENT_INTERVAL_ONE), frame C(D3DPRESENT_INTERVAL_ONE), frame D(D3DPRESENT_INTERVAL_FORCEIMMEDIATE), frame D will override frame C's present interval. The displayed frames per present interval are frame A, frame B, (frame C overridden by) frame D.

See Remarks.

D3DPRESENT_INTERVAL_DEFAULT

This is nearly equivalent to D3DPRESENT_INTERVAL_ONE. See remarks.

D3DPRESENT_INTERVAL_ONE

The driver will wait for the vertical retrace period (the runtime will "beam follow" to prevent tearing). Present operations will not be affected more frequently than the screen refresh; the runtime will complete at most one Present operation per adapter refresh period. This is equivalent to using D3DSWAPEFFECT_COPYVSYNC in DirectX 8.1. This option is always available for both windowed and full-screen swap chains. See remarks.

D3DPRESENT_INTERVAL_TWO

The driver will wait for the vertical retrace period. Present operations will not be affected more frequently than every second screen refresh. Check the PresentationIntervals cap (see D3DCAPS9) to see if D3DPRESENT_INTERVAL_TWO is supported by the driver.

D3DPRESENT_INTERVAL_THREE

The driver will wait for the vertical retrace period. Present operations will not be affected more frequently than every third screen refresh. Check the PresentationIntervals cap (see D3DCAPS9) to see if D3DPRESENT_INTERVAL_THREE is supported by the driver.

D3DPRESENT_INTERVAL_FOUR

The driver will wait for the vertical retrace period. Present operations will not be affected more frequently than every fourth screen refresh. Check the PresentationIntervals member (see D3DCAPS9) to see if D3DPRESENT_INTERVAL_FOUR is supported by the driver.

D3DPRESENT_INTERVAL_IMMEDIATE

The runtime updates the window client area immediately and might do so more than once during the adapter refresh period. This is equivalent to using D3DSWAPEFFECT_COPY in DirectX 8. Present operations might be affected immediately. This option is always available for both windowed and full-screen swap chains. See remarks.

D3DPRESENT_LINEAR_CONTENT

The content of the back buffer to be presented is in the linear color space.

  • The presentation will implicitly convert from linear space to sRGB (gamma = 2.2). This is the only conversion that is supported.
  • Because this flag represents a property of the content of the back buffer, the flag can be specified during an Present call. In other words, an application can present linear content in one frame, and then switch to corrected content in the next.
  • This flag is ignored when the swap chain is full screen. (Note that this flag is available only on the explicit swap chain version of Present. The Present method does not take a flags parameter.)
  • This flag is always accepted, but will only take effect when the driver exposes >D3DCAPS3_LINEAR_TO_SRGB_PresentATION.
  • The only back buffer format supported is X8R8G8B8.

See Windowed Swap Chains.

D3DPRESENT_VIDEO_RESTRICT_TO_MONITOR

Clips the rendered contents to the monitor/device the adapter is targeting, shows thumbnails for the content in the Flip3D view and taskbar thumbnails on other monitors.

This flag is available in Direct3D 9Ex only.

See Desktop Window Manager for further details on this feature of Windows Vista. If you are not running in desktop composition mode, the flag gives the same behavior as D3DPRESENTFLAG_DEVICECLIP.

D3DPRESENT_UPDATEOVERLAYONLY

Updates the overlay position or the colorkey data without causing an actual flip and without changing the duration with which the image is displayed.

This flag is available in Direct3D 9Ex only.

D3DPRESENT_HIDEOVERLAY

Turns off the overlay hardware.

This flag is available in Direct3D 9Ex only.

D3DPRESENT_UPDATECOLORKEY

Redraws the colorkey data.

This flag is available in Direct3D 9Ex only.

Remarks

Windowed mode supports D3DPRESENT_INTERVAL_DEFAULT, D3DPRESENT_INTERVAL_IMMEDIATE, and D3DPRESENT_INTERVAL_ONE. D3DPRESENT_INTERVAL_DEFAULT and the D3DPRESENT_INTERVAL_ONE are nearly equivalent (see the information regarding timer resolution below). They perform similarly to COPY_VSYNC in that there is only one present per frame, and they prevent tearing with beam-following. In contrast, D3DPRESENT_INTERVAL_IMMEDIATE will attempt to provide an unlimited presentation rate.

Full-screen mode supports similar usage as windowed mode by supporting D3DPRESENT_INTERVAL_IMMEDIATE regardless of the refresh rate or swap effect. D3DPRESENT_INTERVAL_DEFAULT uses the default system timer resolution whereas the D3DPRESENT_INTERVAL_ONE calls timeBeginPeriod to enhance system timer resolution. This improves the quality of vertical sync, but consumes slightly more processing time. Both parameters attempt to synchronize vertically.

Requirements

Header

D3d9.h

 

 

Community Additions

ADD
Show:
© 2014 Microsoft