IDirect3DDevice9Ex interface (d3d9.h)
Applications use the methods of the IDirect3DDevice9Ex interface to render primitives, create resources, work with system-level variables, adjust gamma ramp levels, work with palettes, and create shaders. The IDirect3DDevice9Ex interface derives from the IDirect3DDevice9 interface.
Inheritance
The IDirect3DDevice9Ex interface inherits from IDirect3DDevice9. IDirect3DDevice9Ex also has these types of members:
Methods
The IDirect3DDevice9Ex interface has these methods.
| IDirect3DDevice9Ex::CheckDeviceState Reports the current cooperative-level status of the Direct3D device for a windowed or full-screen application. (IDirect3DDevice9Ex.CheckDeviceState) |
| IDirect3DDevice9Ex::CheckResourceResidency Checks an array of resources to determine if it is likely that they will cause a large stall at Draw time because the system must make the resources GPU-accessible. |
| IDirect3DDevice9Ex::ComposeRects Copy a text string to one surface using an alphabet of glyphs on another surface. Composition is done by the GPU using bitwise operations. |
| IDirect3DDevice9Ex::CreateDepthStencilSurfaceEx Creates a depth-stencil surface. |
| IDirect3DDevice9Ex::CreateOffscreenPlainSurfaceEx Create an off-screen surface. (IDirect3DDevice9Ex.CreateOffscreenPlainSurfaceEx) |
| IDirect3DDevice9Ex::CreateRenderTargetEx Creates a render-target surface. (IDirect3DDevice9Ex.CreateRenderTargetEx) |
| IDirect3DDevice9Ex::GetDisplayModeEx Retrieves the display mode's spatial resolution, color resolution, refresh frequency, and rotation settings. (IDirect3DDevice9Ex.GetDisplayModeEx) |
| IDirect3DDevice9Ex::GetGPUThreadPriority Get the priority of the GPU thread. |
| IDirect3DDevice9Ex::GetMaximumFrameLatency Retrieves the number of frames of data that the system is allowed to queue. |
| IDirect3DDevice9Ex::PresentEx Swap the swapchain's next buffer with the front buffer. |
| IDirect3DDevice9Ex::ResetEx Resets the type, size, and format of the swap chain with all other surfaces persistent. |
| IDirect3DDevice9Ex::SetConvolutionMonoKernel Prepare the texture sampler for monochrome convolution filtering on a single-color texture. |
| IDirect3DDevice9Ex::SetGPUThreadPriority Set the priority on the GPU thread. |
| IDirect3DDevice9Ex::SetMaximumFrameLatency Set the number of frames that the system is allowed to queue for rendering. |
| IDirect3DDevice9Ex::TestCooperativeLevel Reports the current cooperative-level status of the Direct3D device for a windowed or full-screen application. (IDirect3DDevice9Ex.TestCooperativeLevel) |
| IDirect3DDevice9Ex::WaitForVBlank Suspend execution of the calling thread until the next vertical blank signal. |
Remarks
The IDirect3DDevice9Ex interface is obtained by calling IDirect3D9Ex::CreateDeviceEx.
The LPDIRECT3DDEVICE9EX and PDIRECT3DDEVICE9EX types are defined as pointers to the IDirect3DDevice9Ex interface:
typedef struct IDirect3DDevice9Ex *LPDIRECT3DDEVICE9EX, *PDIRECT3DDEVICE9EX;
Creating a Device
Follow these two steps to initialize a Direct3D device:- Call Direct3DCreate9Ex to create the Direct3D object.
- Call CreateDeviceEx to create the Direct3D device.
IDirect3D9Ex *pDirect3DEx;
LPDIRECT3DDEVICE9EX pDeviceEx;
DWORD behaviorFlags = D3DCREATE_HARDWARE_VERTEXPROCESSING;
Direct3DCreate9Ex(D3D_SDK_VERSION, &pDirect3DEx);
pDirect3DEx->CreateDeviceEx(D3DADAPTER_DEFAULT, D3DDEVTYPE_HAL, hWnd, behaviorFlags, &d3dpp, NULL, &pDeviceEx);
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | d3d9.h |