Microsoft DirectX 9.0 |
The presentation application programming interfaces (APIs) are a set of methods that control the state of the device that affects what the user sees on the monitor. These methods include setting display modes and once-per-frame methods that are used to present images to the user.
Familiarity with the following terms is necessary to understand the presentation APIs.
Because Microsoft® Direct3D® for Microsoft DirectX® 9.0 has one swap chain as a property of the device, there is always at least one swap chain per device. The IDirect3DDevice9 interface has a set of methods that manipulate the implicit swap chain and are a copy of the swap chain's own interface. Applications can create additional swap chains; however, this is not necessary for the typical single window or full-screen application.
The front buffer is not directly exposed in the Direct3D API for DirectX 9.0. As a result, applications cannot lock or render to the front buffer. For details, see Accessing the Color Front Buffer.
A call to IDirect3D9::CreateDevice represents an implicit reset of the device. The DirectX 9.0 API has no notion of a primary surface; you cannot create an object that represents the primary surface. It is considered to be an internal property of the device.
Gamma ramps are associated with a swap chain and are manipulated with the IDirect3DDevice9::GetGammaRamp and IDirect3DDevice9::SetGammaRamp methods.