Share via

D3DMPROFILE (Windows CE 5.0)

  • Article

Send Feedback

This enumeration identifies all of the Direct3D Mobile profiles defined by Microsoft. All Direct3D Mobile drivers must support the base profile, D3DMPROFILE_BASE.

typedef enum _D3DMPROFILE {  D3DMPROFILE_BASE        = 0,  D3DMPROFILE_FORCE_DWORD = 0x7fffffff,} D3DMPROFILE;

Elements

  • D3DMPROFILE_BASE
    Indicates the most fundamental Direct3D Mobile device profile. The following list identifies the capabilities that a device must support to meet the requirements for the base profile.

    1. All possible flexible vertex format (FVF) combinations. Although a device does not need to implement all features (4 texture stages, for example), it must be able to stride or access all FVF buffers.
    2. World, view, and projection transformations.
    3. Correct drawing of all primitive types according to Direct3D Mobile Rasterization Rules.
    4. The device must support both direct and index vertex buffer accesses.
    5. Both 16 and 32-bit indexes.
    6. Flat shading and all fill modes.
    7. Scene presentation via swap effect.
    8. The creation of, and rasterization to, an off-screen back buffer.
    9. Hidden surface removal. Its depth buffer must support the operators for > (less than)' or -> (less than or equal to) operators.
    10. The creation and locking of image surfaces, vertex buffers, and index buffers.
    11. Clearing the back buffer and depth buffer.
    12. The viewport transformation with clipping to the viewport.
    13. Either vertex fog or pixel fog.
    14. The 2-D operations for the IDirect3DMobileDevice::ColorFill and IDirect3DMobileDevice::StretchRect methods.
    15. The D3DMPRESENT_INTERVAL_ONE presentation parameter .
    16. At least one of the color types RGB, xRGB, or RGBA for surfaces and textures. The type(s) supported for the surfaces and textures need not be identical.
    17. Both the culling of counterclockwise vertices (D3DMPMISCCAPS_CULLCCW) as well as the ability to not cull back faces (D3DMPMISCCAPS_CULLNONE). For more information, see D3DMPMISCCAPS Values.
    18. Scissoring to the viewport. For more information, see Clipping.
    19. Lighting. Support for specular lighting is optional and indicated by the D3DMRS_SPECULARENABLE capability bit. For more information, see D3DMDEVCAPS Values.

    The following table shows the capability bits that a base profile-compliant driver must expose.

    Capability Category Capability Bit
    Presentation Intervals D3DMPRESENT_INTERVAL_DEFAULT

    D3DMPRESENT_INTERVAL_ONE
    SurfaceCaps D3DMSURFCAPS_SYSFRONTBUFFER or D3DMSURFCAPS_VIDFRONTBUFFER

    D3DMSURFCAPS_SYSBACKBUFFER or D3DMSURFCAPS_VIDBACKBUFFER

    D3DMSURFCAPS_SYSDEPTHBUFFER or D3DMSURFCAPS_VIDDEPTHBUFFER

    D3DMSURFCAPS_SYSVERTEXBUFFER or D3DMSURFCAPS_VIDVERTEXBUFFER

    D3DMSURFCAPS_SYSINDEXBUFFER or D3DMSURFCAPS_VIDINDEXBUFFER

    D3DMSURFCAPS_SYSIMAGESURFACE or D3DMSURFCAPS_VIDIMAGESURFACE
    PrimitiveMiscCaps D3DMPMISCCAPS_CULLNONE

    D3DMPMISCCAPS_CULLCCW
    RasterCaps D3DMPRASTERCAPS_WFOG or D3DMPRASTERCAPS_ZFOG

    D3DMPRASTERCAPS_FOGVERTEX or D3DMPRASTERCAPS_FOGTABLE
    ZCmpCaps D3DMPCMPCAPS_NEVER

    D3DMPCMPCAPS_LESS or D3DMPCMPCAPS_LESSEQUAL

    D3DMPCMPCAPS_ALWAYS
    BlendOpCaps D3DMBLENDOPCAPS_ADD              
    ShadeCaps D3DMPSHADECAPS_COLORGOURAUDRGB       
    VertexProcessingCaps D3DMVTXPCAPS_DIRECTIONALLIGHTS

    D3DMVTXPCAPS_POSITIONALLIGHTS

    The following table shows the render state modes that a base profile-compliant driver must support.

    Render State Mode
    D3DMRS_SHADEMODE D3DMSHADE_FLAT

    D3DMSHADE_GOURAUD
    D3DMRS_FILLMODE D3DMFILL_POINT

    D3DMFILL_WIREFRAME

    D3DMFILL_SOLID
    D3DMRS_ZWRITEENABLE TRUE / FALSE
    D3DMRS_LASTPIXEL TRUE / FALSE
    D3DMRS_CULLMODE D3DMCULL_NONE

    D3DMCULL_CCW
    D3DMRS_ZFUNC D3DMCMP_NEVER

    D3DMCMP_ALWAYS

    D3DMCMP_LESS or D3DMCMP_LESSEQUAL
    D3DMRS_FOGENABLE TRUE / FALSE
    D3DMRS_FOGCOLOR D3DMCOLORVALUE
    D3DMRS_FOGTABLEMODE or D3DMRS_FOGVERTEXMODE D3DMFOG_NONE

    D3DMFOG_EXP

    D3DMFOG_EXP2

    D3DMFOG_LINEAR
    D3DMRS_FOGSTART D3DMVALUE
    D3DMRS_FOGEND D3DMVALUE
    D3DMRS_FOGDENSITY D3DMVALUE
    D3DMRS_CLIPPING TRUE / FALSE
    D3DMRS_LIGHTING TRUE / FALSE
    D3DMRS_AMBIENT D3DMCOLOR
    D3DMRS_COLORVERTEX TRUE / FALSE
    D3DMRS_DIFFUSEMATERIALSOURCE D3DMMCS_MATERIAL

    D3DMMCS_COLOR1
    D3DMRS_AMBIENTMATERIALSOURCE D3DMMCS_MATERIAL

    D3DMMCS_COLOR1
    D3DMRS_ZENABLE D3DMZB_FALSE

    D3DMZB_TRUE or D3DMZB_USEW

    The following list shows the the render target formats that base profile-compliant drivers must support. Image surfaces and texture target surfaces (if supported) must support at least one of the surface format types in this list.

    • D3DMFMT_A8R8G8B8
    • D3DMFMT_R5G6B5
    • D3DMFMT_X1R5G5B5
    • D3DMFMT_X8R8G8B8

  • D3DMPROFILE_FORCE_DWORD
    Forces the compiler to interpret the enumeration as a ULONG value. This value is not used directly in Direct3D Mobile programming.

Requirements

OS Versions: Windows CE 5.0 and later.
Header: D3dmtypes.h.

See Also

Direct3D Mobile Enumerations | IDirect3DMobileDevice::ColorFill | IDirect3DMobileDevice::StretchRect | D3DMPMISCCAPS Values | D3DMDEVCAPS Values

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.