CONST_DDSURFACECAPSFLAGS
The CONST_DDSURFACECAPSFLAGS enumeration is used in the lCaps member of the DDSCAPS2 type to describe the capabilities of the surface.
Enum CONST_DDSURFACECAPSFLAGS
DDSCAPS_3DDEVICE = 8192
DDSCAPS_ALLOCONLOAD = 67108864
DDSCAPS_ALPHA = 2
DDSCAPS_BACKBUFFER = 4
DDSCAPS_COMPLEX = 8
DDSCAPS_FLIP = 16
DDSCAPS_FRONTBUFFER = 32
DDSCAPS_HWCODEC = 1048576
DDSCAPS_LIVEVIDEO = 524288
DDSCAPS_LOCALVIDMEM = 268435456
DDSCAPS_MIPMAP = 4194304
DDSCAPS_MODEX = 2097152
DDSCAPS_NONLOCALVIDMEM = 536870912
DDSCAPS_OFFSCREENPLAIN = 64
DDSCAPS_OPTIMIZED = -2147483648
DDSCAPS_OVERLAY = 128
DDSCAPS_OWNDC = 262144
DDSCAPS_PALETTE = 256
DDSCAPS_PRIMARYSURFACE = 512
DDSCAPS_RESERVED2 = 8388608
DDSCAPS_STANDARDVGAMODE = 1073741824
DDSCAPS_SYSTEMMEMORY = 2048
DDSCAPS_TEXTURE = 4096
DDSCAPS_VIDEOMEMORY = 16384
DDSCAPS_VIDEOPORT = 134217728
DDSCAPS_VISIBLE = 32768
DDSCAPS_WRITEONLY = 65536
DDSCAPS_ZBUFFER = 131072
End Enum
- DDSCAPS_3DDEVICE
- This surface can be used for 3-D rendering. Applications can use this flag to ensure that a device that can render only to a certain heap has allocated from the correct heap. If this flag is set for a heap, the surface is not allocated from that heap.
- DDSCAPS_ALLOCONLOAD
- Not used; ignored by DirectDraw and Direct3D.
- DDSCAPS_ALPHA
- This surface contains alpha-only information.
- DDSCAPS_BACKBUFFER
- This surface is the of a surface flipping type. Typically, this capability is set by the CreateSurface method when the DDSCAPS_FLIP flag is used. Only the surface that immediately precedes the DDSCAPS_FRONTBUFFER surface has this capability set. The other surfaces are identified as by the presence of the DDSCAPS_FLIP flag, their attachment order, and the absence of the DDSCAPS_FRONTBUFFER and DDSCAPS_BACKBUFFER capabilities. If this capability is sent to the CreateSurface method, a stand-alone is being created. After this method is called, this surface could be attached to a , another , or both to form a type. For more information, see DirectDrawSurface7.AddAttachedSurface. DirectDraw supports an arbitrary number of surfaces in a flipping type.
- DDSCAPS_COMPLEX
- A is being described. A results in the creation of more than one surface. The additional surfaces are attached to the root surface. The complex type can be destroyed only by destroying the root.
- DDSCAPS_FLIP
- This surface is a part of a surface flipping type. When this capability is passed to the CreateSurface method, a and one or more are created. DirectDraw sets the DDSCAPS_FRONTBUFFER bit on the front-buffer surface and the DDSCAPS_BACKBUFFER bit on the surface adjacent to the front-buffer surface. The lBackBufferCount member of the DDSURFACEDESC2 type must be set to at least 1 for the method call to succeed. The DDSCAPS_COMPLEX capability must always be set when creating multiple surfaces by using the CreateSurface method.
- DDSCAPS_FRONTBUFFER
- This surface is the of a surface flipping type. This flag is typically set by the CreateSurface method when the DDSCAPS_FLIP capability is set. If this capability is sent to the CreateSurface method, a stand-alone is created. This surface does not have the DDSCAPS_FLIP capability. It can be attached to other to form a flipping type by using DirectDrawSurface7.AddAttachedSurface.
- DDSCAPS_HWCODEC
- This surface can have a stream decompressed to it by the hardware.
- DDSCAPS_LIVEVIDEO
- This surface can receive live video.
- DDSCAPS_LOCALVIDMEM
- This surface exists in true, local video memory, rather than nonlocal video memory. If this flag is specified, DDSCAPS_VIDEOMEMORY must be specified, as well. This flag cannot be used with the DDSCAPS_NONLOCALVIDMEM flag.
- DDSCAPS_MIPMAP
- This surface is one level of a . This surface is attached to other DDSCAPS_MIPMAP surfaces to form the . This can be done explicitly by creating a number of surfaces and attaching them by using the DirectDrawSurface7.AddAttachedSurface method, or implicitly by the CreateSurface method. If this capability is set, DDSCAPS_TEXTURE must also be set.
- DDSCAPS_MODEX
- This surface is a 320×200 or 320×240 surface.
- DDSCAPS_NONLOCALVIDMEM
- This surface exists in nonlocal video memory, rather than true, local video memory. If this flag is specified, DDSCAPS_VIDEOMEMORY flag must be specified, as well. This cannot be used with the DDSCAPS_LOCALVIDMEM flag.
- DDSCAPS_OFFSCREENPLAIN
- This surface is any that is not an overlay, texture, z-buffer, front-buffer, back-buffer, or alpha surface. It is used to identify plain surfaces.
- DDSCAPS_OPTIMIZED
- Not currently implemented.
- DDSCAPS_OVERLAY
- This surface is an overlay. It might or might not be directly visible, depending on whether it is currently being overlaid onto the . DDSCAPS_VISIBLE can be used to determine if it is currently being overlaid.
- DDSCAPS_OWNDC
- This surface has a device context (DC) association for a long period of time.
- DDSCAPS_PALETTE
- This device driver allows unique DirectDrawPalette objects to be created and attached to this surface.
- DDSCAPS_PRIMARYSURFACE
- Surface is the . It represents what is currently visible.
- DDSCAPS_RESERVED2
- Reserved for future use.
- DDSCAPS_STANDARDVGAMODE
- This surface is a standard VGA mode surface, and not a Mode X surface. This flag cannot be used in combination with the DDSCAPS_MODEX flag.
- DDSCAPS_SYSTEMMEMORY
- This surface memory was allocated in system memory.
- DDSCAPS_TEXTURE
- This surface can be used as a 3-D texture. This member does not indicate whether the surface is being used for that purpose.
- DDSCAPS_VIDEOMEMORY
- This surface exists in display memory.
- DDSCAPS_VIDEOPORT
- This surface can receive data from a video port.
- DDSCAPS_VISIBLE
- Changes made to this surface are immediately visible. It is always set for the , as well as for overlays while they are being overlaid and texture maps while they are being textured.
- DDSCAPS_WRITEONLY
- Only write access is permitted to the surface. Read access from the surface can generate a general protection (GP) fault, but the read results from this surface are not meaningful.
- DDSCAPS_ZBUFFER
- This surface is the z-buffer. The z-buffer contains information that cannot be displayed. Instead, it contains bit-depth information that is used to determine which pixels are visible and which are obscured.