IDirect3DDevice9Ex interface
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.
Members
The IDirect3DDevice9Ex interface inherits from IDirect3DDevice9. IDirect3DDevice9Ex also has these types of members:
Methods
The IDirect3DDevice9Ex interface has these methods.
| Method | Description |
|---|---|
| CheckDeviceState |
Reports the current cooperative-level status of the Direct3D device for a windowed or full-screen application. |
| 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. |
| 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. |
| CreateDepthStencilSurfaceEx |
Creates a depth-stencil surface. |
| CreateOffscreenPlainSurfaceEx |
Create an off-screen surface. |
| CreateRenderTargetEx |
Creates a render-target surface. |
| GetDisplayModeEx |
Retrieves the display mode's spatial resolution, color resolution, refresh frequency, and rotation settings. |
| GetGPUThreadPriority |
Get the priority of the GPU thread. |
| GetMaximumFrameLatency |
Retrieves the number of frames of data that the system is allowed to queue. |
| PresentEx |
Swap the swapchain's next buffer with the front buffer. |
| ResetEx |
Resets the type, size, and format of the swap chain with all other surfaces persistent. |
| SetConvolutionMonoKernel |
Prepare the texture sampler for monochrome convolution filtering on a single-color texture. |
| SetGPUThreadPriority |
Set the priority on the GPU thread. |
| SetMaximumFrameLatency |
Set the number of frames that the system is allowed to queue for rendering. |
| TestCooperativeLevel |
Note
TestCooperativeLevel is no longer available for use. Instead, use CheckDeviceState.
Reports the current cooperative-level status of the Direct3D device for a windowed or full-screen application. |
| 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.
Here is an example:
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
|
Header |
|
|---|---|
|
Library |
|
See also