Microsoft DirectX 9.0 SDK Update (October 2004)

CreateFlags Enumeration

Language:

Note: This documentation is preliminary and is subject to change.

Defines the flags to use when creating a device.

Definition

Visual Basic .NET Public Enum CreateFlags
C# public enum CreateFlags
Managed C++ __value public enum CreateFlags
JScript .NET public enum CreateFlags

Members

Member Value Description
NoWindowChanges 2048 Indicates to the Microsoft® Direct3D® runtime not to alter the focus window in any way. Use with caution! The burden of supporting focus management events (alt-tab, etc.) falls on the application, and appropriate responses (switching display mode, etc.) should be coded.
DisableDriverManagementEx 1024 Specifies that resources be managed by Microsoft® Direct3D® instead of the driver. Microsoft® Direct3D® calls will fail for resource errors such as insufficient video memory.
AdapterGroupDevice 512 The application requests that the device drive all heads that the master adapter owns (this flag is illegal on non-master adapters). If the flag is set, the presentation parameters passed to Device should be an array of PresentParameters that contains exactly NumberOfAdaptersInGroup elements. The runtime assigns each element to each head in AdapterOrdinalInGroup numeric order.
DisableDriverManagement 256 Specifies that resources be managed by Microsoft® Direct3D® instead of the driver. Microsoft® Direct3D® calls will not fail for resource errors such as insufficient video memory.
MixedVertexProcessing 128 Specifies mixed vertex processing (both software and hardware).
HardwareVertexProcessing 64 Specifies hardware vertex processing.
SoftwareVertexProcessing 32 Specifies software vertex processing.
PureDevice 16 Specifies that Microsoft® Direct3D® not support Get calls for anything that can be stored in a state block. Also instructs Microsoft® Direct3D® to withhold emulation services for vertex processing, which means that if the device does not support vertex processing, the application can use only post-transformed vertices.
MultiThreaded 4 Indicates that the application requested multithread safety in Microsoft® Direct3D®. This causes Microsoft® Direct3D® to check its global critical section more frequently, which can degrade performance. In Microsoft® DirectX® 9.1 for Managed Code, this enumerated value is always specified unless the PresentParameters.ForceNoMultiThreadedFlag is set to true.
FpuPreserve 2 Indicates that the application needs either floating-point unit (FPU) exceptions or double-precision FPU exceptions enabled. By default, Microsoft® Direct3D® uses single precision.

Because Microsoft® Direct3D® sets the FPU state every time it is called, setting this flag reduces Microsoft® Direct3D® performance.

Remarks

This enumeration is used by the Device constructor. The HardwareVertexProcessing, MixedVertexProcessing, and SoftwareVertexProcessing constants are mutually exclusive. One of them must be specified during creation of a Device.

Enumeration Information

Namespace Microsoft.DirectX.Direct3D
Assembly Microsoft.DirectX.Direct3D (microsoft.directx.direct3d.dll)
Strong Name Microsoft.DirectX.Direct3D,  Version=1.0.2902.0,  Culture=neutral,  PublicKeyToken=31bf3856ad364e35

See Also


© 2004 Microsoft Corporation. All rights reserved. Terms of use.

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center