ddraw.h
上传用户:dzyhzl
上传日期:2019-04-29
资源大小:56270k
文件大小:236k
- #define DDSCAPS2_MIPMAPSUBLEVEL 0x00010000L
- /* This flag indicates that the texture should be managed by D3D only */
- #define DDSCAPS2_D3DTEXTUREMANAGE 0x00020000L
- /* This flag indicates that the managed surface can be safely lost */
- #define DDSCAPS2_DONOTPERSIST 0x00040000L
- /* indicates that this surface is part of a stereo flipping chain */
- #define DDSCAPS2_STEREOSURFACELEFT 0x00080000L
- /*
- * Indicates that the surface is a volume.
- * Can be combined with DDSCAPS_MIPMAP to indicate a multi-level volume
- */
- #define DDSCAPS2_VOLUME 0x00200000L
- /*
- * Indicates that the surface may be locked multiple times by the application.
- * This cap cannot be used with DDSCAPS2_OPAQUE.
- */
- #define DDSCAPS2_NOTUSERLOCKABLE 0x00400000L
- /*
- * Indicates that the vertex buffer data can be used to render points and
- * point sprites.
- */
- #define DDSCAPS2_POINTS 0x00800000L
- /*
- * Indicates that the vertex buffer data can be used to render rt pactches.
- */
- #define DDSCAPS2_RTPATCHES 0x01000000L
- /*
- * Indicates that the vertex buffer data can be used to render n patches.
- */
- #define DDSCAPS2_NPATCHES 0x02000000L
- /*
- * This bit is reserved for internal use
- */
- #define DDSCAPS2_RESERVED3 0x04000000L
- /*
- * Indicates that the contents of the backbuffer do not have to be preserved
- * the contents of the backbuffer after they are presented.
- */
- #define DDSCAPS2_DISCARDBACKBUFFER 0x10000000L
- /*
- * This is a mask that indicates the set of bits that may be set
- * at createsurface time to indicate number of samples per pixel
- * when multisampling
- */
- #define DDSCAPS3_MULTISAMPLE_MASK 0x0000001FL
- /****************************************************************************
- *
- * DIRECTDRAW DRIVER CAPABILITY FLAGS
- *
- ****************************************************************************/
- /*
- * Display hardware has 3D acceleration.
- */
- #define DDCAPS_3D 0x00000001l
- /*
- * Indicates that DirectDraw will support only dest rectangles that are aligned
- * on DIRECTDRAWCAPS.dwAlignBoundaryDest boundaries of the surface, respectively.
- * READ ONLY.
- */
- #define DDCAPS_ALIGNBOUNDARYDEST 0x00000002l
- /*
- * Indicates that DirectDraw will support only source rectangles whose sizes in
- * BYTEs are DIRECTDRAWCAPS.dwAlignSizeDest multiples, respectively. READ ONLY.
- */
- #define DDCAPS_ALIGNSIZEDEST 0x00000004l
- /*
- * Indicates that DirectDraw will support only source rectangles that are aligned
- * on DIRECTDRAWCAPS.dwAlignBoundarySrc boundaries of the surface, respectively.
- * READ ONLY.
- */
- #define DDCAPS_ALIGNBOUNDARYSRC 0x00000008l
- /*
- * Indicates that DirectDraw will support only source rectangles whose sizes in
- * BYTEs are DIRECTDRAWCAPS.dwAlignSizeSrc multiples, respectively. READ ONLY.
- */
- #define DDCAPS_ALIGNSIZESRC 0x00000010l
- /*
- * Indicates that DirectDraw will create video memory surfaces that have a stride
- * alignment equal to DIRECTDRAWCAPS.dwAlignStride. READ ONLY.
- */
- #define DDCAPS_ALIGNSTRIDE 0x00000020l
- /*
- * Display hardware is capable of blt operations.
- */
- #define DDCAPS_BLT 0x00000040l
- /*
- * Display hardware is capable of asynchronous blt operations.
- */
- #define DDCAPS_BLTQUEUE 0x00000080l
- /*
- * Display hardware is capable of color space conversions during the blt operation.
- */
- #define DDCAPS_BLTFOURCC 0x00000100l
- /*
- * Display hardware is capable of stretching during blt operations.
- */
- #define DDCAPS_BLTSTRETCH 0x00000200l
- /*
- * Display hardware is shared with GDI.
- */
- #define DDCAPS_GDI 0x00000400l
- /*
- * Display hardware can overlay.
- */
- #define DDCAPS_OVERLAY 0x00000800l
- /*
- * Set if display hardware supports overlays but can not clip them.
- */
- #define DDCAPS_OVERLAYCANTCLIP 0x00001000l
- /*
- * Indicates that overlay hardware is capable of color space conversions during
- * the overlay operation.
- */
- #define DDCAPS_OVERLAYFOURCC 0x00002000l
- /*
- * Indicates that stretching can be done by the overlay hardware.
- */
- #define DDCAPS_OVERLAYSTRETCH 0x00004000l
- /*
- * Indicates that unique DirectDrawPalettes can be created for DirectDrawSurfaces
- * other than the primary surface.
- */
- #define DDCAPS_PALETTE 0x00008000l
- /*
- * Indicates that palette changes can be syncd with the veritcal refresh.
- */
- #define DDCAPS_PALETTEVSYNC 0x00010000l
- /*
- * Display hardware can return the current scan line.
- */
- #define DDCAPS_READSCANLINE 0x00020000l
- /*
- * This flag used to bo DDCAPS_STEREOVIEW, which is now obsolete
- */
- #define DDCAPS_RESERVED1 0x00040000l
- /*
- * Display hardware is capable of generating a vertical blank interrupt.
- */
- #define DDCAPS_VBI 0x00080000l
- /*
- * Supports the use of z buffers with blt operations.
- */
- #define DDCAPS_ZBLTS 0x00100000l
- /*
- * Supports Z Ordering of overlays.
- */
- #define DDCAPS_ZOVERLAYS 0x00200000l
- /*
- * Supports color key
- */
- #define DDCAPS_COLORKEY 0x00400000l
- /*
- * Supports alpha surfaces
- */
- #define DDCAPS_ALPHA 0x00800000l
- /*
- * colorkey is hardware assisted(DDCAPS_COLORKEY will also be set)
- */
- #define DDCAPS_COLORKEYHWASSIST 0x01000000l
- /*
- * no hardware support at all
- */
- #define DDCAPS_NOHARDWARE 0x02000000l
- /*
- * Display hardware is capable of color fill with bltter
- */
- #define DDCAPS_BLTCOLORFILL 0x04000000l
- /*
- * Display hardware is bank switched, and potentially very slow at
- * random access to VRAM.
- */
- #define DDCAPS_BANKSWITCHED 0x08000000l
- /*
- * Display hardware is capable of depth filling Z-buffers with bltter
- */
- #define DDCAPS_BLTDEPTHFILL 0x10000000l
- /*
- * Display hardware is capable of clipping while bltting.
- */
- #define DDCAPS_CANCLIP 0x20000000l
- /*
- * Display hardware is capable of clipping while stretch bltting.
- */
- #define DDCAPS_CANCLIPSTRETCHED 0x40000000l
- /*
- * Display hardware is capable of bltting to or from system memory
- */
- #define DDCAPS_CANBLTSYSMEM 0x80000000l
- /****************************************************************************
- *
- * MORE DIRECTDRAW DRIVER CAPABILITY FLAGS (dwCaps2)
- *
- ****************************************************************************/
- /*
- * Display hardware is certified
- */
- #define DDCAPS2_CERTIFIED 0x00000001l
- /*
- * Driver cannot interleave 2D operations (lock and blt) to surfaces with
- * Direct3D rendering operations between calls to BeginScene() and EndScene()
- */
- #define DDCAPS2_NO2DDURING3DSCENE 0x00000002l
- /*
- * Display hardware contains a video port
- */
- #define DDCAPS2_VIDEOPORT 0x00000004l
- /*
- * The overlay can be automatically flipped according to the video port
- * VSYNCs, providing automatic doubled buffered display of video port
- * data using an overlay
- */
- #define DDCAPS2_AUTOFLIPOVERLAY 0x00000008l
- /*
- * Overlay can display each field of interlaced data individually while
- * it is interleaved in memory without causing jittery artifacts.
- */
- #define DDCAPS2_CANBOBINTERLEAVED 0x00000010l
- /*
- * Overlay can display each field of interlaced data individually while
- * it is not interleaved in memory without causing jittery artifacts.
- */
- #define DDCAPS2_CANBOBNONINTERLEAVED 0x00000020l
- /*
- * The overlay surface contains color controls (brightness, sharpness, etc.)
- */
- #define DDCAPS2_COLORCONTROLOVERLAY 0x00000040l
- /*
- * The primary surface contains color controls (gamma, etc.)
- */
- #define DDCAPS2_COLORCONTROLPRIMARY 0x00000080l
- /*
- * RGBZ -> RGB supported for 16:16 RGB:Z
- */
- #define DDCAPS2_CANDROPZ16BIT 0x00000100l
- /*
- * Driver supports non-local video memory.
- */
- #define DDCAPS2_NONLOCALVIDMEM 0x00000200l
- /*
- * Dirver supports non-local video memory but has different capabilities for
- * non-local video memory surfaces. If this bit is set then so must
- * DDCAPS2_NONLOCALVIDMEM.
- */
- #define DDCAPS2_NONLOCALVIDMEMCAPS 0x00000400l
- /*
- * Driver neither requires nor prefers surfaces to be pagelocked when performing
- * blts involving system memory surfaces
- */
- #define DDCAPS2_NOPAGELOCKREQUIRED 0x00000800l
- /*
- * Driver can create surfaces which are wider than the primary surface
- */
- #define DDCAPS2_WIDESURFACES 0x00001000l
- /*
- * Driver supports bob without using a video port by handling the
- * DDFLIP_ODD and DDFLIP_EVEN flags specified in Flip.
- */
- #define DDCAPS2_CANFLIPODDEVEN 0x00002000l
- /*
- * Driver supports bob using hardware
- */
- #define DDCAPS2_CANBOBHARDWARE 0x00004000l
- /*
- * Driver supports bltting any FOURCC surface to another surface of the same FOURCC
- */
- #define DDCAPS2_COPYFOURCC 0x00008000l
- /*
- * Driver supports loadable gamma ramps for the primary surface
- */
- #define DDCAPS2_PRIMARYGAMMA 0x00020000l
- /*
- * Driver can render in windowed mode.
- */
- #define DDCAPS2_CANRENDERWINDOWED 0x00080000l
- /*
- * A calibrator is available to adjust the gamma ramp according to the
- * physical display properties so that the result will be identical on
- * all calibrated systems.
- */
- #define DDCAPS2_CANCALIBRATEGAMMA 0x00100000l
- /*
- * Indicates that the driver will respond to DDFLIP_INTERVALn flags
- */
- #define DDCAPS2_FLIPINTERVAL 0x00200000l
- /*
- * Indicates that the driver will respond to DDFLIP_NOVSYNC
- */
- #define DDCAPS2_FLIPNOVSYNC 0x00400000l
- /*
- * Driver supports management of video memory, if this flag is ON,
- * driver manages the texture if requested with DDSCAPS2_TEXTUREMANAGE on
- * DirectX manages the texture if this flag is OFF and surface has DDSCAPS2_TEXTUREMANAGE on
- */
- #define DDCAPS2_CANMANAGETEXTURE 0x00800000l
- /*
- * The Direct3D texture manager uses this cap to decide whether to put managed
- * surfaces in non-local video memory. If the cap is set, the texture manager will
- * put managed surfaces in non-local vidmem. Drivers that cannot texture from
- * local vidmem SHOULD NOT set this cap.
- */
- #define DDCAPS2_TEXMANINNONLOCALVIDMEM 0x01000000l
- /*
- * Indicates that the driver supports DX7 type of stereo in at least one mode (which may
- * not necessarily be the current mode). Applications should use IDirectDraw7 (or higher)
- * ::EnumDisplayModes and check the DDSURFACEDESC.ddsCaps.dwCaps2 field for the presence of
- * DDSCAPS2_STEREOSURFACELEFT to check if a particular mode supports stereo. The application
- * can also use IDirectDraw7(or higher)::GetDisplayMode to check the current mode.
- */
- #define DDCAPS2_STEREO 0x02000000L
- /*
- * This caps bit is intended for internal DirectDraw use.
- * -It is only valid if DDCAPS2_NONLOCALVIDMEMCAPS is set.
- * -If this bit is set, then DDCAPS_CANBLTSYSMEM MUST be set by the driver (and
- * all the assoicated system memory blt caps must be correct).
- * -It implies that the system->video blt caps in DDCAPS also apply to system to
- * nonlocal blts. I.e. the dwSVBCaps, dwSVBCKeyCaps, dwSVBFXCaps and dwSVBRops
- * members of DDCAPS (DDCORECAPS) are filled in correctly.
- * -Any blt from system to nonlocal memory that matches these caps bits will
- * be passed to the driver.
- *
- * NOTE: This is intended to enable the driver itself to do efficient reordering
- * of textures. This is NOT meant to imply that hardware can write into AGP memory.
- * This operation is not currently supported.
- */
- #define DDCAPS2_SYSTONONLOCAL_AS_SYSTOLOCAL 0x04000000L
- /*
- * was DDCAPS2_PUREHAL
- */
- #define DDCAPS2_RESERVED1 0x08000000L
- /*
- * Driver supports management of video memory, if this flag is ON,
- * driver manages the resource if requested with DDSCAPS2_TEXTUREMANAGE on
- * DirectX manages the resource if this flag is OFF and surface has DDSCAPS2_TEXTUREMANAGE on
- */
- #define DDCAPS2_CANMANAGERESOURCE 0x10000000L
- /*
- * Driver supports dynamic textures. This will allow the application to set
- * D3DUSAGE_DYNAMIC (DDSCAPS2_HINTDYNAMIC for drivers) at texture create time.
- * Video memory dynamic textures WILL be lockable by applications. It is
- * expected that these locks will be very efficient (which implies that the
- * driver should always maintain a linear copy, a pointer to which can be
- * quickly handed out to the application).
- */
- #define DDCAPS2_DYNAMICTEXTURES 0x20000000L
- /****************************************************************************
- *
- * DIRECTDRAW FX ALPHA CAPABILITY FLAGS
- *
- ****************************************************************************/
- /*
- * Supports alpha blending around the edge of a source color keyed surface.
- * For Blt.
- */
- #define DDFXALPHACAPS_BLTALPHAEDGEBLEND 0x00000001l
- /*
- * Supports alpha information in the pixel format. The bit depth of alpha
- * information in the pixel format can be 1,2,4, or 8. The alpha value becomes
- * more opaque as the alpha value increases. (0 is transparent.)
- * For Blt.
- */
- #define DDFXALPHACAPS_BLTALPHAPIXELS 0x00000002l
- /*
- * Supports alpha information in the pixel format. The bit depth of alpha
- * information in the pixel format can be 1,2,4, or 8. The alpha value
- * becomes more transparent as the alpha value increases. (0 is opaque.)
- * This flag can only be set if DDCAPS_ALPHA is set.
- * For Blt.
- */
- #define DDFXALPHACAPS_BLTALPHAPIXELSNEG 0x00000004l
- /*
- * Supports alpha only surfaces. The bit depth of an alpha only surface can be
- * 1,2,4, or 8. The alpha value becomes more opaque as the alpha value increases.
- * (0 is transparent.)
- * For Blt.
- */
- #define DDFXALPHACAPS_BLTALPHASURFACES 0x00000008l
- /*
- * The depth of the alpha channel data can range can be 1,2,4, or 8.
- * The NEG suffix indicates that this alpha channel becomes more transparent
- * as the alpha value increases. (0 is opaque.) This flag can only be set if
- * DDCAPS_ALPHA is set.
- * For Blt.
- */
- #define DDFXALPHACAPS_BLTALPHASURFACESNEG 0x00000010l
- /*
- * Supports alpha blending around the edge of a source color keyed surface.
- * For Overlays.
- */
- #define DDFXALPHACAPS_OVERLAYALPHAEDGEBLEND 0x00000020l
- /*
- * Supports alpha information in the pixel format. The bit depth of alpha
- * information in the pixel format can be 1,2,4, or 8. The alpha value becomes
- * more opaque as the alpha value increases. (0 is transparent.)
- * For Overlays.
- */
- #define DDFXALPHACAPS_OVERLAYALPHAPIXELS 0x00000040l
- /*
- * Supports alpha information in the pixel format. The bit depth of alpha
- * information in the pixel format can be 1,2,4, or 8. The alpha value
- * becomes more transparent as the alpha value increases. (0 is opaque.)
- * This flag can only be set if DDCAPS_ALPHA is set.
- * For Overlays.
- */
- #define DDFXALPHACAPS_OVERLAYALPHAPIXELSNEG 0x00000080l
- /*
- * Supports alpha only surfaces. The bit depth of an alpha only surface can be
- * 1,2,4, or 8. The alpha value becomes more opaque as the alpha value increases.
- * (0 is transparent.)
- * For Overlays.
- */
- #define DDFXALPHACAPS_OVERLAYALPHASURFACES 0x00000100l
- /*
- * The depth of the alpha channel data can range can be 1,2,4, or 8.
- * The NEG suffix indicates that this alpha channel becomes more transparent
- * as the alpha value increases. (0 is opaque.) This flag can only be set if
- * DDCAPS_ALPHA is set.
- * For Overlays.
- */
- #define DDFXALPHACAPS_OVERLAYALPHASURFACESNEG 0x00000200l
- #if DIRECTDRAW_VERSION < 0x0600
- #endif //DIRECTDRAW_VERSION
- /****************************************************************************
- *
- * DIRECTDRAW FX CAPABILITY FLAGS
- *
- ****************************************************************************/
- /*
- * Uses arithmetic operations to stretch and shrink surfaces during blt
- * rather than pixel doubling techniques. Along the Y axis.
- */
- #define DDFXCAPS_BLTARITHSTRETCHY 0x00000020l
- /*
- * Uses arithmetic operations to stretch during blt
- * rather than pixel doubling techniques. Along the Y axis. Only
- * works for x1, x2, etc.
- */
- #define DDFXCAPS_BLTARITHSTRETCHYN 0x00000010l
- /*
- * Supports mirroring left to right in blt.
- */
- #define DDFXCAPS_BLTMIRRORLEFTRIGHT 0x00000040l
- /*
- * Supports mirroring top to bottom in blt.
- */
- #define DDFXCAPS_BLTMIRRORUPDOWN 0x00000080l
- /*
- * Supports arbitrary rotation for blts.
- */
- #define DDFXCAPS_BLTROTATION 0x00000100l
- /*
- * Supports 90 degree rotations for blts.
- */
- #define DDFXCAPS_BLTROTATION90 0x00000200l
- /*
- * DirectDraw supports arbitrary shrinking of a surface along the
- * x axis (horizontal direction) for blts.
- */
- #define DDFXCAPS_BLTSHRINKX 0x00000400l
- /*
- * DirectDraw supports integer shrinking (1x,2x,) of a surface
- * along the x axis (horizontal direction) for blts.
- */
- #define DDFXCAPS_BLTSHRINKXN 0x00000800l
- /*
- * DirectDraw supports arbitrary shrinking of a surface along the
- * y axis (horizontal direction) for blts.
- */
- #define DDFXCAPS_BLTSHRINKY 0x00001000l
- /*
- * DirectDraw supports integer shrinking (1x,2x,) of a surface
- * along the y axis (vertical direction) for blts.
- */
- #define DDFXCAPS_BLTSHRINKYN 0x00002000l
- /*
- * DirectDraw supports arbitrary stretching of a surface along the
- * x axis (horizontal direction) for blts.
- */
- #define DDFXCAPS_BLTSTRETCHX 0x00004000l
- /*
- * DirectDraw supports integer stretching (1x,2x,) of a surface
- * along the x axis (horizontal direction) for blts.
- */
- #define DDFXCAPS_BLTSTRETCHXN 0x00008000l
- /*
- * DirectDraw supports arbitrary stretching of a surface along the
- * y axis (horizontal direction) for blts.
- */
- #define DDFXCAPS_BLTSTRETCHY 0x00010000l
- /*
- * DirectDraw supports integer stretching (1x,2x,) of a surface
- * along the y axis (vertical direction) for blts.
- */
- #define DDFXCAPS_BLTSTRETCHYN 0x00020000l
- /*
- * Uses arithmetic operations to stretch and shrink surfaces during
- * overlay rather than pixel doubling techniques. Along the Y axis
- * for overlays.
- */
- #define DDFXCAPS_OVERLAYARITHSTRETCHY 0x00040000l
- /*
- * Uses arithmetic operations to stretch surfaces during
- * overlay rather than pixel doubling techniques. Along the Y axis
- * for overlays. Only works for x1, x2, etc.
- */
- #define DDFXCAPS_OVERLAYARITHSTRETCHYN 0x00000008l
- /*
- * DirectDraw supports arbitrary shrinking of a surface along the
- * x axis (horizontal direction) for overlays.
- */
- #define DDFXCAPS_OVERLAYSHRINKX 0x00080000l
- /*
- * DirectDraw supports integer shrinking (1x,2x,) of a surface
- * along the x axis (horizontal direction) for overlays.
- */
- #define DDFXCAPS_OVERLAYSHRINKXN 0x00100000l
- /*
- * DirectDraw supports arbitrary shrinking of a surface along the
- * y axis (horizontal direction) for overlays.
- */
- #define DDFXCAPS_OVERLAYSHRINKY 0x00200000l
- /*
- * DirectDraw supports integer shrinking (1x,2x,) of a surface
- * along the y axis (vertical direction) for overlays.
- */
- #define DDFXCAPS_OVERLAYSHRINKYN 0x00400000l
- /*
- * DirectDraw supports arbitrary stretching of a surface along the
- * x axis (horizontal direction) for overlays.
- */
- #define DDFXCAPS_OVERLAYSTRETCHX 0x00800000l
- /*
- * DirectDraw supports integer stretching (1x,2x,) of a surface
- * along the x axis (horizontal direction) for overlays.
- */
- #define DDFXCAPS_OVERLAYSTRETCHXN 0x01000000l
- /*
- * DirectDraw supports arbitrary stretching of a surface along the
- * y axis (horizontal direction) for overlays.
- */
- #define DDFXCAPS_OVERLAYSTRETCHY 0x02000000l
- /*
- * DirectDraw supports integer stretching (1x,2x,) of a surface
- * along the y axis (vertical direction) for overlays.
- */
- #define DDFXCAPS_OVERLAYSTRETCHYN 0x04000000l
- /*
- * DirectDraw supports mirroring of overlays across the vertical axis
- */
- #define DDFXCAPS_OVERLAYMIRRORLEFTRIGHT 0x08000000l
- /*
- * DirectDraw supports mirroring of overlays across the horizontal axis
- */
- #define DDFXCAPS_OVERLAYMIRRORUPDOWN 0x10000000l
- /*
- * DirectDraw supports deinterlacing of overlay surfaces
- */
- #define DDFXCAPS_OVERLAYDEINTERLACE 0x20000000l
- /*
- * Driver can do alpha blending for blits.
- */
- #define DDFXCAPS_BLTALPHA 0x00000001l
- /*
- * Driver can do surface-reconstruction filtering for warped blits.
- */
- #define DDFXCAPS_BLTFILTER DDFXCAPS_BLTARITHSTRETCHY
- /*
- * Driver can do alpha blending for overlays.
- */
- #define DDFXCAPS_OVERLAYALPHA 0x00000004l
- /*
- * Driver can do surface-reconstruction filtering for warped overlays.
- */
- #define DDFXCAPS_OVERLAYFILTER DDFXCAPS_OVERLAYARITHSTRETCHY
- /****************************************************************************
- *
- * DIRECTDRAW STEREO VIEW CAPABILITIES
- *
- ****************************************************************************/
- /*
- * This flag used to be DDSVCAPS_ENIGMA, which is now obsolete
- */
- #define DDSVCAPS_RESERVED1 0x00000001l
- /*
- * This flag used to be DDSVCAPS_FLICKER, which is now obsolete
- */
- #define DDSVCAPS_RESERVED2 0x00000002l
- /*
- * This flag used to be DDSVCAPS_REDBLUE, which is now obsolete
- */
- #define DDSVCAPS_RESERVED3 0x00000004l
- /*
- * This flag used to be DDSVCAPS_SPLIT, which is now obsolete
- */
- #define DDSVCAPS_RESERVED4 0x00000008l
- /*
- * The stereo view is accomplished with switching technology
- */
- #define DDSVCAPS_STEREOSEQUENTIAL 0x00000010L
- /****************************************************************************
- *
- * DIRECTDRAWPALETTE CAPABILITIES
- *
- ****************************************************************************/
- /*
- * Index is 4 bits. There are sixteen color entries in the palette table.
- */
- #define DDPCAPS_4BIT 0x00000001l
- /*
- * Index is onto a 8 bit color index. This field is only valid with the
- * DDPCAPS_1BIT, DDPCAPS_2BIT or DDPCAPS_4BIT capability and the target
- * surface is in 8bpp. Each color entry is one byte long and is an index
- * into destination surface's 8bpp palette.
- */
- #define DDPCAPS_8BITENTRIES 0x00000002l
- /*
- * Index is 8 bits. There are 256 color entries in the palette table.
- */
- #define DDPCAPS_8BIT 0x00000004l
- /*
- * Indicates that this DIRECTDRAWPALETTE should use the palette color array
- * passed into the lpDDColorArray parameter to initialize the DIRECTDRAWPALETTE
- * object.
- * This flag is obsolete. DirectDraw always initializes the color array from
- * the lpDDColorArray parameter. The definition remains for source-level
- * compatibility.
- */
- #define DDPCAPS_INITIALIZE 0x00000000l
- /*
- * This palette is the one attached to the primary surface. Changing this
- * table has immediate effect on the display unless DDPSETPAL_VSYNC is specified
- * and supported.
- */
- #define DDPCAPS_PRIMARYSURFACE 0x00000010l
- /*
- * This palette is the one attached to the primary surface left. Changing
- * this table has immediate effect on the display for the left eye unless
- * DDPSETPAL_VSYNC is specified and supported.
- */
- #define DDPCAPS_PRIMARYSURFACELEFT 0x00000020l
- /*
- * This palette can have all 256 entries defined
- */
- #define DDPCAPS_ALLOW256 0x00000040l
- /*
- * This palette can have modifications to it synced with the monitors
- * refresh rate.
- */
- #define DDPCAPS_VSYNC 0x00000080l
- /*
- * Index is 1 bit. There are two color entries in the palette table.
- */
- #define DDPCAPS_1BIT 0x00000100l
- /*
- * Index is 2 bit. There are four color entries in the palette table.
- */
- #define DDPCAPS_2BIT 0x00000200l
- /*
- * The peFlags member of PALETTEENTRY denotes an 8 bit alpha value
- */
- #define DDPCAPS_ALPHA 0x00000400l
- /****************************************************************************
- *
- * DIRECTDRAWPALETTE SETENTRY CONSTANTS
- *
- ****************************************************************************/
- /****************************************************************************
- *
- * DIRECTDRAWPALETTE GETENTRY CONSTANTS
- *
- ****************************************************************************/
- /* 0 is the only legal value */
- /****************************************************************************
- *
- * DIRECTDRAWSURFACE SETPRIVATEDATA CONSTANTS
- *
- ****************************************************************************/
- /*
- * The passed pointer is an IUnknown ptr. The cbData argument to SetPrivateData
- * must be set to sizeof(IUnknown*). DirectDraw will call AddRef through this
- * pointer and Release when the private data is destroyed. This includes when
- * the surface or palette is destroyed before such priovate data is destroyed.
- */
- #define DDSPD_IUNKNOWNPOINTER 0x00000001L
- /*
- * Private data is only valid for the current state of the object,
- * as determined by the uniqueness value.
- */
- #define DDSPD_VOLATILE 0x00000002L
- /****************************************************************************
- *
- * DIRECTDRAWSURFACE SETPALETTE CONSTANTS
- *
- ****************************************************************************/
- /****************************************************************************
- *
- * DIRECTDRAW BITDEPTH CONSTANTS
- *
- * NOTE: These are only used to indicate supported bit depths. These
- * are flags only, they are not to be used as an actual bit depth. The
- * absolute numbers 1, 2, 4, 8, 16, 24 and 32 are used to indicate actual
- * bit depths in a surface or for changing the display mode.
- *
- ****************************************************************************/
- /*
- * 1 bit per pixel.
- */
- #define DDBD_1 0x00004000l
- /*
- * 2 bits per pixel.
- */
- #define DDBD_2 0x00002000l
- /*
- * 4 bits per pixel.
- */
- #define DDBD_4 0x00001000l
- /*
- * 8 bits per pixel.
- */
- #define DDBD_8 0x00000800l
- /*
- * 16 bits per pixel.
- */
- #define DDBD_16 0x00000400l
- /*
- * 24 bits per pixel.
- */
- #define DDBD_24 0X00000200l
- /*
- * 32 bits per pixel.
- */
- #define DDBD_32 0x00000100l
- /****************************************************************************
- *
- * DIRECTDRAWSURFACE SET/GET COLOR KEY FLAGS
- *
- ****************************************************************************/
- /*
- * Set if the structure contains a color space. Not set if the structure
- * contains a single color key.
- */
- #define DDCKEY_COLORSPACE 0x00000001l
- /*
- * Set if the structure specifies a color key or color space which is to be
- * used as a destination color key for blt operations.
- */
- #define DDCKEY_DESTBLT 0x00000002l
- /*
- * Set if the structure specifies a color key or color space which is to be
- * used as a destination color key for overlay operations.
- */
- #define DDCKEY_DESTOVERLAY 0x00000004l
- /*
- * Set if the structure specifies a color key or color space which is to be
- * used as a source color key for blt operations.
- */
- #define DDCKEY_SRCBLT 0x00000008l
- /*
- * Set if the structure specifies a color key or color space which is to be
- * used as a source color key for overlay operations.
- */
- #define DDCKEY_SRCOVERLAY 0x00000010l
- /****************************************************************************
- *
- * DIRECTDRAW COLOR KEY CAPABILITY FLAGS
- *
- ****************************************************************************/
- /*
- * Supports transparent blting using a color key to identify the replaceable
- * bits of the destination surface for RGB colors.
- */
- #define DDCKEYCAPS_DESTBLT 0x00000001l
- /*
- * Supports transparent blting using a color space to identify the replaceable
- * bits of the destination surface for RGB colors.
- */
- #define DDCKEYCAPS_DESTBLTCLRSPACE 0x00000002l
- /*
- * Supports transparent blting using a color space to identify the replaceable
- * bits of the destination surface for YUV colors.
- */
- #define DDCKEYCAPS_DESTBLTCLRSPACEYUV 0x00000004l
- /*
- * Supports transparent blting using a color key to identify the replaceable
- * bits of the destination surface for YUV colors.
- */
- #define DDCKEYCAPS_DESTBLTYUV 0x00000008l
- /*
- * Supports overlaying using colorkeying of the replaceable bits of the surface
- * being overlayed for RGB colors.
- */
- #define DDCKEYCAPS_DESTOVERLAY 0x00000010l
- /*
- * Supports a color space as the color key for the destination for RGB colors.
- */
- #define DDCKEYCAPS_DESTOVERLAYCLRSPACE 0x00000020l
- /*
- * Supports a color space as the color key for the destination for YUV colors.
- */
- #define DDCKEYCAPS_DESTOVERLAYCLRSPACEYUV 0x00000040l
- /*
- * Supports only one active destination color key value for visible overlay
- * surfaces.
- */
- #define DDCKEYCAPS_DESTOVERLAYONEACTIVE 0x00000080l
- /*
- * Supports overlaying using colorkeying of the replaceable bits of the
- * surface being overlayed for YUV colors.
- */
- #define DDCKEYCAPS_DESTOVERLAYYUV 0x00000100l
- /*
- * Supports transparent blting using the color key for the source with
- * this surface for RGB colors.
- */
- #define DDCKEYCAPS_SRCBLT 0x00000200l
- /*
- * Supports transparent blting using a color space for the source with
- * this surface for RGB colors.
- */
- #define DDCKEYCAPS_SRCBLTCLRSPACE 0x00000400l
- /*
- * Supports transparent blting using a color space for the source with
- * this surface for YUV colors.
- */
- #define DDCKEYCAPS_SRCBLTCLRSPACEYUV 0x00000800l
- /*
- * Supports transparent blting using the color key for the source with
- * this surface for YUV colors.
- */
- #define DDCKEYCAPS_SRCBLTYUV 0x00001000l
- /*
- * Supports overlays using the color key for the source with this
- * overlay surface for RGB colors.
- */
- #define DDCKEYCAPS_SRCOVERLAY 0x00002000l
- /*
- * Supports overlays using a color space as the source color key for
- * the overlay surface for RGB colors.
- */
- #define DDCKEYCAPS_SRCOVERLAYCLRSPACE 0x00004000l
- /*
- * Supports overlays using a color space as the source color key for
- * the overlay surface for YUV colors.
- */
- #define DDCKEYCAPS_SRCOVERLAYCLRSPACEYUV 0x00008000l
- /*
- * Supports only one active source color key value for visible
- * overlay surfaces.
- */
- #define DDCKEYCAPS_SRCOVERLAYONEACTIVE 0x00010000l
- /*
- * Supports overlays using the color key for the source with this
- * overlay surface for YUV colors.
- */
- #define DDCKEYCAPS_SRCOVERLAYYUV 0x00020000l
- /*
- * there are no bandwidth trade-offs for using colorkey with an overlay
- */
- #define DDCKEYCAPS_NOCOSTOVERLAY 0x00040000l
- /****************************************************************************
- *
- * DIRECTDRAW PIXELFORMAT FLAGS
- *
- ****************************************************************************/
- /*
- * The surface has alpha channel information in the pixel format.
- */
- #define DDPF_ALPHAPIXELS 0x00000001l
- /*
- * The pixel format contains alpha only information
- */
- #define DDPF_ALPHA 0x00000002l
- /*
- * The FourCC code is valid.
- */
- #define DDPF_FOURCC 0x00000004l
- /*
- * The surface is 4-bit color indexed.
- */
- #define DDPF_PALETTEINDEXED4 0x00000008l
- /*
- * The surface is indexed into a palette which stores indices
- * into the destination surface's 8-bit palette.
- */
- #define DDPF_PALETTEINDEXEDTO8 0x00000010l
- /*
- * The surface is 8-bit color indexed.
- */
- #define DDPF_PALETTEINDEXED8 0x00000020l
- /*
- * The RGB data in the pixel format structure is valid.
- */
- #define DDPF_RGB 0x00000040l
- /*
- * The surface will accept pixel data in the format specified
- * and compress it during the write.
- */
- #define DDPF_COMPRESSED 0x00000080l
- /*
- * The surface will accept RGB data and translate it during
- * the write to YUV data. The format of the data to be written
- * will be contained in the pixel format structure. The DDPF_RGB
- * flag will be set.
- */
- #define DDPF_RGBTOYUV 0x00000100l
- /*
- * pixel format is YUV - YUV data in pixel format struct is valid
- */
- #define DDPF_YUV 0x00000200l
- /*
- * pixel format is a z buffer only surface
- */
- #define DDPF_ZBUFFER 0x00000400l
- /*
- * The surface is 1-bit color indexed.
- */
- #define DDPF_PALETTEINDEXED1 0x00000800l
- /*
- * The surface is 2-bit color indexed.
- */
- #define DDPF_PALETTEINDEXED2 0x00001000l
- /*
- * The surface contains Z information in the pixels
- */
- #define DDPF_ZPIXELS 0x00002000l
- /*
- * The surface contains stencil information along with Z
- */
- #define DDPF_STENCILBUFFER 0x00004000l
- /*
- * Premultiplied alpha format -- the color components have been
- * premultiplied by the alpha component.
- */
- #define DDPF_ALPHAPREMULT 0x00008000l
- /*
- * Luminance data in the pixel format is valid.
- * Use this flag for luminance-only or luminance+alpha surfaces,
- * the bit depth is then ddpf.dwLuminanceBitCount.
- */
- #define DDPF_LUMINANCE 0x00020000l
- /*
- * Luminance data in the pixel format is valid.
- * Use this flag when hanging luminance off bumpmap surfaces,
- * the bit mask for the luminance portion of the pixel is then
- * ddpf.dwBumpLuminanceBitMask
- */
- #define DDPF_BUMPLUMINANCE 0x00040000l
- /*
- * Bump map dUdV data in the pixel format is valid.
- */
- #define DDPF_BUMPDUDV 0x00080000l
- /*===========================================================================
- *
- *
- * DIRECTDRAW CALLBACK FLAGS
- *
- *
- *==========================================================================*/
- /****************************************************************************
- *
- * DIRECTDRAW ENUMSURFACES FLAGS
- *
- ****************************************************************************/
- /*
- * Enumerate all of the surfaces that meet the search criterion.
- */
- #define DDENUMSURFACES_ALL 0x00000001l
- /*
- * A search hit is a surface that matches the surface description.
- */
- #define DDENUMSURFACES_MATCH 0x00000002l
- /*
- * A search hit is a surface that does not match the surface description.
- */
- #define DDENUMSURFACES_NOMATCH 0x00000004l
- /*
- * Enumerate the first surface that can be created which meets the search criterion.
- */
- #define DDENUMSURFACES_CANBECREATED 0x00000008l
- /*
- * Enumerate the surfaces that already exist that meet the search criterion.
- */
- #define DDENUMSURFACES_DOESEXIST 0x00000010l
- /****************************************************************************
- *
- * DIRECTDRAW SETDISPLAYMODE FLAGS
- *
- ****************************************************************************/
- /*
- * The desired mode is a standard VGA mode
- */
- #define DDSDM_STANDARDVGAMODE 0x00000001l
- /****************************************************************************
- *
- * DIRECTDRAW ENUMDISPLAYMODES FLAGS
- *
- ****************************************************************************/
- /*
- * Enumerate Modes with different refresh rates. EnumDisplayModes guarantees
- * that a particular mode will be enumerated only once. This flag specifies whether
- * the refresh rate is taken into account when determining if a mode is unique.
- */
- #define DDEDM_REFRESHRATES 0x00000001l
- /*
- * Enumerate VGA modes. Specify this flag if you wish to enumerate supported VGA
- * modes such as mode 0x13 in addition to the usual ModeX modes (which are always
- * enumerated if the application has previously called SetCooperativeLevel with the
- * DDSCL_ALLOWMODEX flag set).
- */
- #define DDEDM_STANDARDVGAMODES 0x00000002L
- /****************************************************************************
- *
- * DIRECTDRAW SETCOOPERATIVELEVEL FLAGS
- *
- ****************************************************************************/
- /*
- * Exclusive mode owner will be responsible for the entire primary surface.
- * GDI can be ignored. used with DD
- */
- #define DDSCL_FULLSCREEN 0x00000001l
- /*
- * allow CTRL_ALT_DEL to work while in fullscreen exclusive mode
- */
- #define DDSCL_ALLOWREBOOT 0x00000002l
- /*
- * prevents DDRAW from modifying the application window.
- * prevents DDRAW from minimize/restore the application window on activation.
- */
- #define DDSCL_NOWINDOWCHANGES 0x00000004l
- /*
- * app wants to work as a regular Windows application
- */
- #define DDSCL_NORMAL 0x00000008l
- /*
- * app wants exclusive access
- */
- #define DDSCL_EXCLUSIVE 0x00000010l
- /*
- * app can deal with non-windows display modes
- */
- #define DDSCL_ALLOWMODEX 0x00000040l
- /*
- * this window will receive the focus messages
- */
- #define DDSCL_SETFOCUSWINDOW 0x00000080l
- /*
- * this window is associated with the DDRAW object and will
- * cover the screen in fullscreen mode
- */
- #define DDSCL_SETDEVICEWINDOW 0x00000100l
- /*
- * app wants DDRAW to create a window to be associated with the
- * DDRAW object
- */
- #define DDSCL_CREATEDEVICEWINDOW 0x00000200l
- /*
- * App explicitly asks DDRAW/D3D to be multithread safe. This makes D3D
- * take the global crtisec more frequently.
- */
- #define DDSCL_MULTITHREADED 0x00000400l
- /*
- * App specifies that it would like to keep the FPU set up for optimal Direct3D
- * performance (single precision and exceptions disabled) so Direct3D
- * does not need to explicitly set the FPU each time. This is assumed by
- * default in DirectX 7. See also DDSCL_FPUPRESERVE
- */
- #define DDSCL_FPUSETUP 0x00000800l
- /*
- * App specifies that it needs either double precision FPU or FPU exceptions
- * enabled. This makes Direct3D explicitly set the FPU state eah time it is
- * called. Setting the flag will reduce Direct3D performance. The flag is
- * assumed by default in DirectX 6 and earlier. See also DDSCL_FPUSETUP
- */
- #define DDSCL_FPUPRESERVE 0x00001000l
- /****************************************************************************
- *
- * DIRECTDRAW BLT FLAGS
- *
- ****************************************************************************/
- /*
- * Use the alpha information in the pixel format or the alpha channel surface
- * attached to the destination surface as the alpha channel for this blt.
- */
- #define DDBLT_ALPHADEST 0x00000001l
- /*
- * Use the dwConstAlphaDest field in the DDBLTFX structure as the alpha channel
- * for the destination surface for this blt.
- */
- #define DDBLT_ALPHADESTCONSTOVERRIDE 0x00000002l
- /*
- * The NEG suffix indicates that the destination surface becomes more
- * transparent as the alpha value increases. (0 is opaque)
- */
- #define DDBLT_ALPHADESTNEG 0x00000004l
- /*
- * Use the lpDDSAlphaDest field in the DDBLTFX structure as the alpha
- * channel for the destination for this blt.
- */
- #define DDBLT_ALPHADESTSURFACEOVERRIDE 0x00000008l
- /*
- * Use the dwAlphaEdgeBlend field in the DDBLTFX structure as the alpha channel
- * for the edges of the image that border the color key colors.
- */
- #define DDBLT_ALPHAEDGEBLEND 0x00000010l
- /*
- * Use the alpha information in the pixel format or the alpha channel surface
- * attached to the source surface as the alpha channel for this blt.
- */
- #define DDBLT_ALPHASRC 0x00000020l
- /*
- * Use the dwConstAlphaSrc field in the DDBLTFX structure as the alpha channel
- * for the source for this blt.
- */
- #define DDBLT_ALPHASRCCONSTOVERRIDE 0x00000040l
- /*
- * The NEG suffix indicates that the source surface becomes more transparent
- * as the alpha value increases. (0 is opaque)
- */
- #define DDBLT_ALPHASRCNEG 0x00000080l
- /*
- * Use the lpDDSAlphaSrc field in the DDBLTFX structure as the alpha channel
- * for the source for this blt.
- */
- #define DDBLT_ALPHASRCSURFACEOVERRIDE 0x00000100l
- /*
- * Do this blt asynchronously through the FIFO in the order received. If
- * there is no room in the hardware FIFO fail the call.
- */
- #define DDBLT_ASYNC 0x00000200l
- /*
- * Uses the dwFillColor field in the DDBLTFX structure as the RGB color
- * to fill the destination rectangle on the destination surface with.
- */
- #define DDBLT_COLORFILL 0x00000400l
- /*
- * Uses the dwDDFX field in the DDBLTFX structure to specify the effects
- * to use for the blt.
- */
- #define DDBLT_DDFX 0x00000800l
- /*
- * Uses the dwDDROPS field in the DDBLTFX structure to specify the ROPS
- * that are not part of the Win32 API.
- */
- #define DDBLT_DDROPS 0x00001000l
- /*
- * Use the color key associated with the destination surface.
- */
- #define DDBLT_KEYDEST 0x00002000l
- /*
- * Use the dckDestColorkey field in the DDBLTFX structure as the color key
- * for the destination surface.
- */
- #define DDBLT_KEYDESTOVERRIDE 0x00004000l
- /*
- * Use the color key associated with the source surface.
- */
- #define DDBLT_KEYSRC 0x00008000l
- /*
- * Use the dckSrcColorkey field in the DDBLTFX structure as the color key
- * for the source surface.
- */
- #define DDBLT_KEYSRCOVERRIDE 0x00010000l
- /*
- * Use the dwROP field in the DDBLTFX structure for the raster operation
- * for this blt. These ROPs are the same as the ones defined in the Win32 API.
- */
- #define DDBLT_ROP 0x00020000l
- /*
- * Use the dwRotationAngle field in the DDBLTFX structure as the angle
- * (specified in 1/100th of a degree) to rotate the surface.
- */
- #define DDBLT_ROTATIONANGLE 0x00040000l
- /*
- * Z-buffered blt using the z-buffers attached to the source and destination
- * surfaces and the dwZBufferOpCode field in the DDBLTFX structure as the
- * z-buffer opcode.
- */
- #define DDBLT_ZBUFFER 0x00080000l
- /*
- * Z-buffered blt using the dwConstDest Zfield and the dwZBufferOpCode field
- * in the DDBLTFX structure as the z-buffer and z-buffer opcode respectively
- * for the destination.
- */
- #define DDBLT_ZBUFFERDESTCONSTOVERRIDE 0x00100000l
- /*
- * Z-buffered blt using the lpDDSDestZBuffer field and the dwZBufferOpCode
- * field in the DDBLTFX structure as the z-buffer and z-buffer opcode
- * respectively for the destination.
- */
- #define DDBLT_ZBUFFERDESTOVERRIDE 0x00200000l
- /*
- * Z-buffered blt using the dwConstSrcZ field and the dwZBufferOpCode field
- * in the DDBLTFX structure as the z-buffer and z-buffer opcode respectively
- * for the source.
- */
- #define DDBLT_ZBUFFERSRCCONSTOVERRIDE 0x00400000l
- /*
- * Z-buffered blt using the lpDDSSrcZBuffer field and the dwZBufferOpCode
- * field in the DDBLTFX structure as the z-buffer and z-buffer opcode
- * respectively for the source.
- */
- #define DDBLT_ZBUFFERSRCOVERRIDE 0x00800000l
- /*
- * wait until the device is ready to handle the blt
- * this will cause blt to not return DDERR_WASSTILLDRAWING
- */
- #define DDBLT_WAIT 0x01000000l
- /*
- * Uses the dwFillDepth field in the DDBLTFX structure as the depth value
- * to fill the destination rectangle on the destination Z-buffer surface
- * with.
- */
- #define DDBLT_DEPTHFILL 0x02000000l
- /*
- * wait until the device is ready to handle the blt
- * this will cause blt to not return DDERR_WASSTILLDRAWING
- */
- #define DDBLT_DONOTWAIT 0x08000000l
- /*
- * These flags indicate a presentation blt (i.e. a blt
- * that moves surface contents from an offscreen back buffer to the primary
- * surface). The driver is not allowed to "queue" more than three such blts.
- * The "end" of the presentation blt is indicated, since the
- * blt may be clipped, in which case the runtime will call the driver with
- * several blts. All blts (even if not clipped) are tagged with DDBLT_PRESENTATION
- * and the last (even if not clipped) additionally with DDBLT_LAST_PRESENTATION.
- * Thus the true rule is that the driver must not schedule a DDBLT_PRESENTATION
- * blt if there are 3 or more DDBLT_PRESENTLAST blts in the hardware pipe.
- * If there are such blts in the pipe, the driver should return DDERR_WASSTILLDRAWING
- * until the oldest queued DDBLT_LAST_PRESENTATION blts has been retired (i.e. the
- * pixels have been actually written to the primary surface). Once the oldest blt
- * has been retired, the driver is free to schedule the current blt.
- * The goal is to provide a mechanism whereby the device's hardware queue never
- * gets more than 3 frames ahead of the frames being generated by the application.
- * When excessive queueing occurs, applications become unusable because the application
- * visibly lags user input, and such problems make windowed interactive applications impossible.
- * Some drivers may not have sufficient knowledge of their hardware's FIFO to know
- * when a certain blt has been retired. Such drivers should code cautiously, and
- * simply not allow any frames to be queued at all. DDBLT_LAST_PRESENTATION should cause
- * such drivers to return DDERR_WASSTILLDRAWING until the accelerator is completely
- * finished- exactly as if the application had called Lock on the source surface
- * before calling Blt.
- * In other words, the driver is allowed and encouraged to
- * generate as much latency as it can, but never more than 3 frames worth.
- * Implementation detail: Drivers should count blts against the SOURCE surface, not
- * against the primary surface. This enables multiple parallel windowed application
- * to function more optimally.
- * This flag is passed only to DX8 or higher drivers.
- *
- * APPLICATIONS DO NOT SET THESE FLAGS. THEY ARE SET BY THE DIRECTDRAW RUNTIME.
- *
- */
- #define DDBLT_PRESENTATION 0x10000000l
- #define DDBLT_LAST_PRESENTATION 0x20000000l
- /****************************************************************************
- *
- * BLTFAST FLAGS
- *
- ****************************************************************************/
- #define DDBLTFAST_NOCOLORKEY 0x00000000
- #define DDBLTFAST_SRCCOLORKEY 0x00000001
- #define DDBLTFAST_DESTCOLORKEY 0x00000002
- #define DDBLTFAST_WAIT 0x00000010
- #define DDBLTFAST_DONOTWAIT 0x00000020
- /****************************************************************************
- *
- * FLIP FLAGS
- *
- ****************************************************************************/
- #define DDFLIP_WAIT 0x00000001L
- /*
- * Indicates that the target surface contains the even field of video data.
- * This flag is only valid with an overlay surface.
- */
- #define DDFLIP_EVEN 0x00000002L
- /*
- * Indicates that the target surface contains the odd field of video data.
- * This flag is only valid with an overlay surface.
- */
- #define DDFLIP_ODD 0x00000004L
- /*
- * Causes DirectDraw to perform the physical flip immediately and return
- * to the application. Typically, what was the front buffer but is now the back
- * buffer will still be visible (depending on timing) until the next vertical
- * retrace. Subsequent operations involving the two flipped surfaces will
- * not check to see if the physical flip has finished (i.e. will not return
- * DDERR_WASSTILLDRAWING for that reason (but may for other reasons)).
- * This allows an application to perform Flips at a higher frequency than the
- * monitor refresh rate, but may introduce visible artifacts.
- * Only effective if DDCAPS2_FLIPNOVSYNC is set. If that bit is not set,
- * DDFLIP_NOVSYNC has no effect.
- */
- #define DDFLIP_NOVSYNC 0x00000008L
- /*
- * Flip Interval Flags. These flags indicate how many vertical retraces to wait between
- * each flip. The default is one. DirectDraw will return DDERR_WASSTILLDRAWING for each
- * surface involved in the flip until the specified number of vertical retraces has
- * ocurred. Only effective if DDCAPS2_FLIPINTERVAL is set. If that bit is not set,
- * DDFLIP_INTERVALn has no effect.
- */
- /*
- * DirectDraw will flip on every other vertical sync
- */
- #define DDFLIP_INTERVAL2 0x02000000L
- /*
- * DirectDraw will flip on every third vertical sync
- */
- #define DDFLIP_INTERVAL3 0x03000000L
- /*
- * DirectDraw will flip on every fourth vertical sync
- */
- #define DDFLIP_INTERVAL4 0x04000000L
- /*
- * DirectDraw will flip and display a main stereo surface
- */
- #define DDFLIP_STEREO 0x00000010L
- /*
- * On IDirectDrawSurface7 and higher interfaces, the default is DDFLIP_WAIT. If you wish
- * to override the default and use time when the accelerator is busy (as denoted by
- * the DDERR_WASSTILLDRAWING return code) then use DDFLIP_DONOTWAIT.
- */
- #define DDFLIP_DONOTWAIT 0x00000020L
- /****************************************************************************
- *
- * DIRECTDRAW SURFACE OVERLAY FLAGS
- *
- ****************************************************************************/
- /*
- * Use the alpha information in the pixel format or the alpha channel surface
- * attached to the destination surface as the alpha channel for the
- * destination overlay.
- */
- #define DDOVER_ALPHADEST 0x00000001l
- /*
- * Use the dwConstAlphaDest field in the DDOVERLAYFX structure as the
- * destination alpha channel for this overlay.
- */
- #define DDOVER_ALPHADESTCONSTOVERRIDE 0x00000002l
- /*
- * The NEG suffix indicates that the destination surface becomes more
- * transparent as the alpha value increases.
- */
- #define DDOVER_ALPHADESTNEG 0x00000004l
- /*
- * Use the lpDDSAlphaDest field in the DDOVERLAYFX structure as the alpha
- * channel destination for this overlay.
- */
- #define DDOVER_ALPHADESTSURFACEOVERRIDE 0x00000008l
- /*
- * Use the dwAlphaEdgeBlend field in the DDOVERLAYFX structure as the alpha
- * channel for the edges of the image that border the color key colors.
- */
- #define DDOVER_ALPHAEDGEBLEND 0x00000010l
- /*
- * Use the alpha information in the pixel format or the alpha channel surface
- * attached to the source surface as the source alpha channel for this overlay.
- */
- #define DDOVER_ALPHASRC 0x00000020l
- /*
- * Use the dwConstAlphaSrc field in the DDOVERLAYFX structure as the source
- * alpha channel for this overlay.
- */
- #define DDOVER_ALPHASRCCONSTOVERRIDE 0x00000040l
- /*
- * The NEG suffix indicates that the source surface becomes more transparent
- * as the alpha value increases.
- */
- #define DDOVER_ALPHASRCNEG 0x00000080l
- /*
- * Use the lpDDSAlphaSrc field in the DDOVERLAYFX structure as the alpha channel
- * source for this overlay.
- */
- #define DDOVER_ALPHASRCSURFACEOVERRIDE 0x00000100l
- /*
- * Turn this overlay off.
- */
- #define DDOVER_HIDE 0x00000200l
- /*
- * Use the color key associated with the destination surface.
- */
- #define DDOVER_KEYDEST 0x00000400l
- /*
- * Use the dckDestColorkey field in the DDOVERLAYFX structure as the color key
- * for the destination surface
- */
- #define DDOVER_KEYDESTOVERRIDE 0x00000800l
- /*
- * Use the color key associated with the source surface.
- */
- #define DDOVER_KEYSRC 0x00001000l
- /*
- * Use the dckSrcColorkey field in the DDOVERLAYFX structure as the color key
- * for the source surface.
- */
- #define DDOVER_KEYSRCOVERRIDE 0x00002000l
- /*
- * Turn this overlay on.
- */
- #define DDOVER_SHOW 0x00004000l
- /*
- * Add a dirty rect to an emulated overlayed surface.
- */
- #define DDOVER_ADDDIRTYRECT 0x00008000l
- /*
- * Redraw all dirty rects on an emulated overlayed surface.
- */
- #define DDOVER_REFRESHDIRTYRECTS 0x00010000l
- /*
- * Redraw the entire surface on an emulated overlayed surface.
- */
- #define DDOVER_REFRESHALL 0x00020000l
- /*
- * Use the overlay FX flags to define special overlay FX
- */
- #define DDOVER_DDFX 0x00080000l
- /*
- * Autoflip the overlay when ever the video port autoflips
- */
- #define DDOVER_AUTOFLIP 0x00100000l
- /*
- * Display each field of video port data individually without
- * causing any jittery artifacts
- */
- #define DDOVER_BOB 0x00200000l
- /*
- * Indicates that bob/weave decisions should not be overridden by other
- * interfaces.
- */
- #define DDOVER_OVERRIDEBOBWEAVE 0x00400000l
- /*
- * Indicates that the surface memory is composed of interleaved fields.
- */
- #define DDOVER_INTERLEAVED 0x00800000l
- /*
- * Indicates that bob will be performed using hardware rather than
- * software or emulated.
- */
- #define DDOVER_BOBHARDWARE 0x01000000l
- /*
- * Indicates that overlay FX structure contains valid ARGB scaling factors.
- */
- #define DDOVER_ARGBSCALEFACTORS 0x02000000l
- /*
- * Indicates that ARGB scaling factors can be degraded to fit driver capabilities.
- */
- #define DDOVER_DEGRADEARGBSCALING 0x04000000l
- /****************************************************************************
- *
- * DIRECTDRAWSURFACE LOCK FLAGS
- *
- ****************************************************************************/
- /*
- * The default. Set to indicate that Lock should return a valid memory pointer
- * to the top of the specified rectangle. If no rectangle is specified then a
- * pointer to the top of the surface is returned.
- */
- #define DDLOCK_SURFACEMEMORYPTR 0x00000000L // default
- /*
- * Set to indicate that Lock should wait until it can obtain a valid memory
- * pointer before returning. If this bit is set, Lock will never return
- * DDERR_WASSTILLDRAWING.
- */
- #define DDLOCK_WAIT 0x00000001L
- /*
- * Set if an event handle is being passed to Lock. Lock will trigger the event
- * when it can return the surface memory pointer requested.
- */
- #define DDLOCK_EVENT 0x00000002L
- /*
- * Indicates that the surface being locked will only be read from.
- */
- #define DDLOCK_READONLY 0x00000010L
- /*
- * Indicates that the surface being locked will only be written to
- */
- #define DDLOCK_WRITEONLY 0x00000020L
- /*
- * Indicates that a system wide lock should not be taken when this surface
- * is locked. This has several advantages (cursor responsiveness, ability
- * to call more Windows functions, easier debugging) when locking video
- * memory surfaces. However, an application specifying this flag must
- * comply with a number of conditions documented in the help file.
- * Furthermore, this flag cannot be specified when locking the primary.
- */
- #define DDLOCK_NOSYSLOCK 0x00000800L
- /*
- * Used only with Direct3D Vertex Buffer Locks. Indicates that no vertices
- * that were referred to in Draw*PrimtiveVB calls since the start of the
- * frame (or the last lock without this flag) will be modified during the
- * lock. This can be useful when one is only appending data to the vertex
- * buffer
- */
- #define DDLOCK_NOOVERWRITE 0x00001000L
- /*
- * Indicates that no assumptions will be made about the contents of the
- * surface or vertex buffer during this lock.
- * This enables two things:
- * - Direct3D or the driver may provide an alternative memory
- * area as the vertex buffer. This is useful when one plans to clear the
- * contents of the vertex buffer and fill in new data.
- * - Drivers sometimes store surface data in a re-ordered format.
- * When the application locks the surface, the driver is forced to un-re-order
- * the surface data before allowing the application to see the surface contents.
- * This flag is a hint to the driver that it can skip the un-re-ordering process
- * since the application plans to overwrite every single pixel in the surface
- * or locked rectangle (and so erase any un-re-ordered pixels anyway).
- * Applications should always set this flag when they intend to overwrite the entire
- * surface or locked rectangle.
- */
- #define DDLOCK_DISCARDCONTENTS 0x00002000L
- /*
- * DDLOCK_OKTOSWAP is an older, less informative name for DDLOCK_DISCARDCONTENTS
- */
- #define DDLOCK_OKTOSWAP 0x00002000L
- /*
- * On IDirectDrawSurface7 and higher interfaces, the default is DDLOCK_WAIT. If you wish
- * to override the default and use time when the accelerator is busy (as denoted by
- * the DDERR_WASSTILLDRAWING return code) then use DDLOCK_DONOTWAIT.
- */
- #define DDLOCK_DONOTWAIT 0x00004000L
- /*
- * This indicates volume texture lock with front and back specified.
- */
- #define DDLOCK_HASVOLUMETEXTUREBOXRECT 0x00008000L
- /*
- * This indicates that the driver should not update dirty rect information for this lock.
- */
- #define DDLOCK_NODIRTYUPDATE 0x00010000L
- /****************************************************************************
- *
- * DIRECTDRAWSURFACE PAGELOCK FLAGS
- *
- ****************************************************************************/
- /*
- * No flags defined at present
- */
- /****************************************************************************
- *
- * DIRECTDRAWSURFACE PAGEUNLOCK FLAGS
- *
- ****************************************************************************/
- /*
- * No flags defined at present
- */
- /****************************************************************************
- *
- * DIRECTDRAWSURFACE BLT FX FLAGS
- *
- ****************************************************************************/
- /*
- * If stretching, use arithmetic stretching along the Y axis for this blt.
- */
- #define DDBLTFX_ARITHSTRETCHY 0x00000001l
- /*
- * Do this blt mirroring the surface left to right. Spin the
- * surface around its y-axis.
- */
- #define DDBLTFX_MIRRORLEFTRIGHT 0x00000002l
- /*
- * Do this blt mirroring the surface up and down. Spin the surface
- * around its x-axis.
- */
- #define DDBLTFX_MIRRORUPDOWN 0x00000004l
- /*
- * Schedule this blt to avoid tearing.
- */
- #define DDBLTFX_NOTEARING 0x00000008l
- /*
- * Do this blt rotating the surface one hundred and eighty degrees.
- */
- #define DDBLTFX_ROTATE180 0x00000010l
- /*
- * Do this blt rotating the surface two hundred and seventy degrees.
- */
- #define DDBLTFX_ROTATE270 0x00000020l
- /*
- * Do this blt rotating the surface ninety degrees.
- */
- #define DDBLTFX_ROTATE90 0x00000040l
- /*
- * Do this z blt using dwZBufferLow and dwZBufferHigh as range values
- * specified to limit the bits copied from the source surface.
- */
- #define DDBLTFX_ZBUFFERRANGE 0x00000080l
- /*
- * Do this z blt adding the dwZBufferBaseDest to each of the sources z values
- * before comparing it with the desting z values.
- */
- #define DDBLTFX_ZBUFFERBASEDEST 0x00000100l
- /****************************************************************************
- *
- * DIRECTDRAWSURFACE OVERLAY FX FLAGS
- *
- ****************************************************************************/
- /*
- * If stretching, use arithmetic stretching along the Y axis for this overlay.
- */
- #define DDOVERFX_ARITHSTRETCHY 0x00000001l
- /*
- * Mirror the overlay across the vertical axis
- */
- #define DDOVERFX_MIRRORLEFTRIGHT 0x00000002l
- /*
- * Mirror the overlay across the horizontal axis
- */
- #define DDOVERFX_MIRRORUPDOWN 0x00000004l
- /*
- * Deinterlace the overlay, if possible
- */
- #define DDOVERFX_DEINTERLACE 0x00000008l
- /****************************************************************************
- *
- * DIRECTDRAW WAITFORVERTICALBLANK FLAGS
- *
- ****************************************************************************/
- /*
- * return when the vertical blank interval begins
- */
- #define DDWAITVB_BLOCKBEGIN 0x00000001l
- /*
- * set up an event to trigger when the vertical blank begins
- */
- #define DDWAITVB_BLOCKBEGINEVENT 0x00000002l
- /*
- * return when the vertical blank interval ends and display begins
- */
- #define DDWAITVB_BLOCKEND 0x00000004l
- /****************************************************************************
- *
- * DIRECTDRAW GETFLIPSTATUS FLAGS
- *
- ****************************************************************************/
- /*
- * is it OK to flip now?
- */
- #define DDGFS_CANFLIP 0x00000001l
- /*
- * is the last flip finished?
- */
- #define DDGFS_ISFLIPDONE 0x00000002l
- /****************************************************************************
- *
- * DIRECTDRAW GETBLTSTATUS FLAGS
- *
- ****************************************************************************/
- /*
- * is it OK to blt now?
- */
- #define DDGBS_CANBLT 0x00000001l
- /*
- * is the blt to the surface finished?
- */
- #define DDGBS_ISBLTDONE 0x00000002l
- /****************************************************************************
- *
- * DIRECTDRAW ENUMOVERLAYZORDER FLAGS
- *
- ****************************************************************************/
- /*
- * Enumerate overlays back to front.
- */
- #define DDENUMOVERLAYZ_BACKTOFRONT 0x00000000l
- /*
- * Enumerate overlays front to back
- */
- #define DDENUMOVERLAYZ_FRONTTOBACK 0x00000001l
- /****************************************************************************
- *
- * DIRECTDRAW UPDATEOVERLAYZORDER FLAGS
- *
- ****************************************************************************/
- /*
- * Send overlay to front
- */
- #define DDOVERZ_SENDTOFRONT 0x00000000l
- /*
- * Send overlay to back
- */
- #define DDOVERZ_SENDTOBACK 0x00000001l
- /*
- * Move Overlay forward
- */
- #define DDOVERZ_MOVEFORWARD 0x00000002l
- /*
- * Move Overlay backward
- */
- #define DDOVERZ_MOVEBACKWARD 0x00000003l
- /*
- * Move Overlay in front of relative surface
- */
- #define DDOVERZ_INSERTINFRONTOF 0x00000004l
- /*
- * Move Overlay in back of relative surface
- */
- #define DDOVERZ_INSERTINBACKOF 0x00000005l
- /****************************************************************************
- *
- * DIRECTDRAW SETGAMMARAMP FLAGS
- *
- ****************************************************************************/
- /*
- * Request calibrator to adjust the gamma ramp according to the physical
- * properties of the display so that the result should appear identical
- * on all systems.
- */
- #define DDSGR_CALIBRATE 0x00000001L
- /****************************************************************************
- *
- * DIRECTDRAW STARTMODETEST FLAGS
- *
- ****************************************************************************/
- /*
- * Indicates that the mode being tested has passed
- */
- #define DDSMT_ISTESTREQUIRED 0x00000001L
- /****************************************************************************
- *
- * DIRECTDRAW EVALUATEMODE FLAGS
- *
- ****************************************************************************/
- /*
- * Indicates that the mode being tested has passed
- */
- #define DDEM_MODEPASSED 0x00000001L
- /*
- * Indicates that the mode being tested has failed
- */
- #define DDEM_MODEFAILED 0x00000002L
- /*===========================================================================
- *
- *
- * DIRECTDRAW RETURN CODES
- *
- * The return values from DirectDraw Commands and Surface that return an HRESULT
- * are codes from DirectDraw concerning the results of the action
- * requested by DirectDraw.
- *
- *==========================================================================*/
- /*
- * Status is OK
- *
- * Issued by: DirectDraw Commands and all callbacks
- */
- #define DD_OK S_OK
- #define DD_FALSE S_FALSE
- /****************************************************************************
- *
- * DIRECTDRAW ENUMCALLBACK RETURN VALUES
- *
- * EnumCallback returns are used to control the flow of the DIRECTDRAW and
- * DIRECTDRAWSURFACE object enumerations. They can only be returned by
- * enumeration callback routines.
- *
- ****************************************************************************/
- /*
- * stop the enumeration
- */
- #define DDENUMRET_CANCEL 0
- /*
- * continue the enumeration
- */
- #define DDENUMRET_OK 1
- /****************************************************************************
- *
- * DIRECTDRAW ERRORS
- *
- * Errors are represented by negative values and cannot be combined.
- *
- ****************************************************************************/
- /*
- * This object is already initialized
- */
- #define DDERR_ALREADYINITIALIZED MAKE_DDHRESULT( 5 )
- /*
- * This surface can not be attached to the requested surface.
- */
- #define DDERR_CANNOTATTACHSURFACE MAKE_DDHRESULT( 10 )
- /*
- * This surface can not be detached from the requested surface.
- */
- #define DDERR_CANNOTDETACHSURFACE MAKE_DDHRESULT( 20 )
- /*
- * Support is currently not available.
- */
- #define DDERR_CURRENTLYNOTAVAIL MAKE_DDHRESULT( 40 )
- /*
- * An exception was encountered while performing the requested operation
- */
- #define DDERR_EXCEPTION MAKE_DDHRESULT( 55 )
- /*
- * Generic failure.
- */
- #define DDERR_GENERIC E_FAIL
- /*
- * Height of rectangle provided is not a multiple of reqd alignment
- */
- #define DDERR_HEIGHTALIGN MAKE_DDHRESULT( 90 )
- /*
- * Unable to match primary surface creation request with existing
- * primary surface.
- */
- #define DDERR_INCOMPATIBLEPRIMARY MAKE_DDHRESULT( 95 )
- /*
- * One or more of the caps bits passed to the callback are incorrect.
- */
- #define DDERR_INVALIDCAPS MAKE_DDHRESULT( 100 )
- /*
- * DirectDraw does not support provided Cliplist.
- */
- #define DDERR_INVALIDCLIPLIST MAKE_DDHRESULT( 110 )
- /*
- * DirectDraw does not support the requested mode
- */
- #define DDERR_INVALIDMODE MAKE_DDHRESULT( 120 )
- /*
- * DirectDraw received a pointer that was an invalid DIRECTDRAW object.
- */
- #define DDERR_INVALIDOBJECT MAKE_DDHRESULT( 130 )
- /*
- * One or more of the parameters passed to the callback function are
- * incorrect.
- */
- #define DDERR_INVALIDPARAMS E_INVALIDARG
- /*
- * pixel format was invalid as specified
- */
- #define DDERR_INVALIDPIXELFORMAT MAKE_DDHRESULT( 145 )
- /*
- * Rectangle provided was invalid.
- */
- #define DDERR_INVALIDRECT MAKE_DDHRESULT( 150 )
- /*
- * Operation could not be carried out because one or more surfaces are locked
- */
- #define DDERR_LOCKEDSURFACES MAKE_DDHRESULT( 160 )
- /*
- * There is no 3D present.
- */
- #define DDERR_NO3D MAKE_DDHRESULT( 170 )
- /*
- * Operation could not be carried out because there is no alpha accleration
- * hardware present or available.
- */
- #define DDERR_NOALPHAHW MAKE_DDHRESULT( 180 )
- /*
- * Operation could not be carried out because there is no stereo
- * hardware present or available.
- */
- #define DDERR_NOSTEREOHARDWARE MAKE_DDHRESULT( 181 )
- /*
- * Operation could not be carried out because there is no hardware
- * present which supports stereo surfaces
- */
- #define DDERR_NOSURFACELEFT MAKE_DDHRESULT( 182 )
- /*
- * no clip list available
- */
- #define DDERR_NOCLIPLIST MAKE_DDHRESULT( 205 )
- /*
- * Operation could not be carried out because there is no color conversion
- * hardware present or available.
- */
- #define DDERR_NOCOLORCONVHW MAKE_DDHRESULT( 210 )
- /*
- * Create function called without DirectDraw object method SetCooperativeLevel
- * being called.
- */
- #define DDERR_NOCOOPERATIVELEVELSET MAKE_DDHRESULT( 212 )
- /*
- * Surface doesn't currently have a color key
- */
- #define DDERR_NOCOLORKEY MAKE_DDHRESULT( 215 )
- /*
- * Operation could not be carried out because there is no hardware support
- * of the dest color key.
- */
- #define DDERR_NOCOLORKEYHW MAKE_DDHRESULT( 220 )
- /*
- * No DirectDraw support possible with current display driver
- */
- #define DDERR_NODIRECTDRAWSUPPORT MAKE_DDHRESULT( 222 )
- /*
- * Operation requires the application to have exclusive mode but the
- * application does not have exclusive mode.
- */
- #define DDERR_NOEXCLUSIVEMODE MAKE_DDHRESULT( 225 )
- /*
- * Flipping visible surfaces is not supported.
- */
- #define DDERR_NOFLIPHW MAKE_DDHRESULT( 230 )
- /*
- * There is no GDI present.
- */
- #define DDERR_NOGDI MAKE_DDHRESULT( 240 )
- /*
- * Operation could not be carried out because there is no hardware present
- * or available.
- */
- #define DDERR_NOMIRRORHW MAKE_DDHRESULT( 250 )
- /*
- * Requested item was not found
- */
- #define DDERR_NOTFOUND MAKE_DDHRESULT( 255 )
- /*
- * Operation could not be carried out because there is no overlay hardware
- * present or available.
- */
- #define DDERR_NOOVERLAYHW MAKE_DDHRESULT( 260 )
- /*
- * Operation could not be carried out because the source and destination
- * rectangles are on the same surface and overlap each other.
- */
- #define DDERR_OVERLAPPINGRECTS MAKE_DDHRESULT( 270 )
- /*
- * Operation could not be carried out because there is no appropriate raster
- * op hardware present or available.
- */
- #define DDERR_NORASTEROPHW MAKE_DDHRESULT( 280 )
- /*
- * Operation could not be carried out because there is no rotation hardware
- * present or available.
- */
- #define DDERR_NOROTATIONHW MAKE_DDHRESULT( 290 )
- /*
- * Operation could not be carried out because there is no hardware support
- * for stretching
- */
- #define DDERR_NOSTRETCHHW MAKE_DDHRESULT( 310 )
- /*
- * DirectDrawSurface is not in 4 bit color palette and the requested operation
- * requires 4 bit color palette.
- */
- #define DDERR_NOT4BITCOLOR MAKE_DDHRESULT( 316 )
- /*
- * DirectDrawSurface is not in 4 bit color index palette and the requested
- * operation requires 4 bit color index palette.
- */
- #define DDERR_NOT4BITCOLORINDEX MAKE_DDHRESULT( 317 )
- /*
- * DirectDraw Surface is not in 8 bit color mode and the requested operation
- * requires 8 bit color.
- */
- #define DDERR_NOT8BITCOLOR MAKE_DDHRESULT( 320 )
- /*
- * Operation could not be carried out because there is no texture mapping
- * hardware present or available.
- */
- #define DDERR_NOTEXTUREHW MAKE_DDHRESULT( 330 )
- /*
- * Operation could not be carried out because there is no hardware support
- * for vertical blank synchronized operations.
- */
- #define DDERR_NOVSYNCHW MAKE_DDHRESULT( 335 )
- /*
- * Operation could not be carried out because there is no hardware support
- * for zbuffer blting.
- */
- #define DDERR_NOZBUFFERHW MAKE_DDHRESULT( 340 )
- /*
- * Overlay surfaces could not be z layered based on their BltOrder because
- * the hardware does not support z layering of overlays.
- */
- #define DDERR_NOZOVERLAYHW MAKE_DDHRESULT( 350 )
- /*
- * The hardware needed for the requested operation has already been
- * allocated.
- */
- #define DDERR_OUTOFCAPS MAKE_DDHRESULT( 360 )
- /*
- * DirectDraw does not have enough memory to perform the operation.
- */
- #define DDERR_OUTOFMEMORY E_OUTOFMEMORY
- /*
- * DirectDraw does not have enough memory to perform the operation.
- */
- #define DDERR_OUTOFVIDEOMEMORY MAKE_DDHRESULT( 380 )
- /*
- * hardware does not support clipped overlays
- */
- #define DDERR_OVERLAYCANTCLIP MAKE_DDHRESULT( 382 )
- /*
- * Can only have ony color key active at one time for overlays
- */
- #define DDERR_OVERLAYCOLORKEYONLYONEACTIVE MAKE_DDHRESULT( 384 )
- /*
- * Access to this palette is being refused because the palette is already
- * locked by another thread.
- */
- #define DDERR_PALETTEBUSY MAKE_DDHRESULT( 387 )
- /*
- * No src color key specified for this operation.
- */
- #define DDERR_COLORKEYNOTSET MAKE_DDHRESULT( 400 )
- /*
- * This surface is already attached to the surface it is being attached to.
- */
- #define DDERR_SURFACEALREADYATTACHED MAKE_DDHRESULT( 410 )
- /*
- * This surface is already a dependency of the surface it is being made a
- * dependency of.
- */
- #define DDERR_SURFACEALREADYDEPENDENT MAKE_DDHRESULT( 420 )
- /*
- * Access to this surface is being refused because the surface is already
- * locked by another thread.
- */
- #define DDERR_SURFACEBUSY MAKE_DDHRESULT( 430 )
- /*
- * Access to this surface is being refused because no driver exists
- * which can supply a pointer to the surface.
- * This is most likely to happen when attempting to lock the primary
- * surface when no DCI provider is present.
- * Will also happen on attempts to lock an optimized surface.
- */
- #define DDERR_CANTLOCKSURFACE MAKE_DDHRESULT( 435 )
- /*
- * Access to Surface refused because Surface is obscured.
- */
- #define DDERR_SURFACEISOBSCURED MAKE_DDHRESULT( 440 )
- /*
- * Access to this surface is being refused because the surface is gone.
- * The DIRECTDRAWSURFACE object representing this surface should
- * have Restore called on it.
- */
- #define DDERR_SURFACELOST MAKE_DDHRESULT( 450 )
- /*
- * The requested surface is not attached.
- */
- #define DDERR_SURFACENOTATTACHED MAKE_DDHRESULT( 460 )
- /*
- * Height requested by DirectDraw is too large.
- */
- #define DDERR_TOOBIGHEIGHT MAKE_DDHRESULT( 470 )
- /*
- * Size requested by DirectDraw is too large -- The individual height and
- * width are OK.
- */
- #define DDERR_TOOBIGSIZE MAKE_DDHRESULT( 480 )
- /*
- * Width requested by DirectDraw is too large.
- */
- #define DDERR_TOOBIGWIDTH MAKE_DDHRESULT( 490 )
- /*
- * Action not supported.
- */
- #define DDERR_UNSUPPORTED E_NOTIMPL
- /*
- * Pixel format requested is unsupported by DirectDraw
- */
- #define DDERR_UNSUPPORTEDFORMAT MAKE_DDHRESULT( 510 )
- /*
- * Bitmask in the pixel format requested is unsupported by DirectDraw
- */
- #define DDERR_UNSUPPORTEDMASK MAKE_DDHRESULT( 520 )
- /*
- * The specified stream contains invalid data
- */
- #define DDERR_INVALIDSTREAM MAKE_DDHRESULT( 521 )
- /*
- * vertical blank is in progress
- */
- #define DDERR_VERTICALBLANKINPROGRESS MAKE_DDHRESULT( 537 )
- /*
- * Informs DirectDraw that the previous Blt which is transfering information
- * to or from this Surface is incomplete.
- */
- #define DDERR_WASSTILLDRAWING MAKE_DDHRESULT( 540 )
- /*
- * The specified surface type requires specification of the COMPLEX flag
- */
- #define DDERR_DDSCAPSCOMPLEXREQUIRED MAKE_DDHRESULT( 542 )
- /*
- * Rectangle provided was not horizontally aligned on reqd. boundary
- */
- #define DDERR_XALIGN MAKE_DDHRESULT( 560 )
- /*
- * The GUID passed to DirectDrawCreate is not a valid DirectDraw driver
- * identifier.
- */
- #define DDERR_INVALIDDIRECTDRAWGUID MAKE_DDHRESULT( 561 )
- /*
- * A DirectDraw object representing this driver has already been created
- * for this process.
- */
- #define DDERR_DIRECTDRAWALREADYCREATED MAKE_DDHRESULT( 562 )
- /*
- * A hardware only DirectDraw object creation was attempted but the driver
- * did not support any hardware.
- */
- #define DDERR_NODIRECTDRAWHW MAKE_DDHRESULT( 563 )
- /*
- * this process already has created a primary surface
- */
- #define DDERR_PRIMARYSURFACEALREADYEXISTS MAKE_DDHRESULT( 564 )
- /*
- * software emulation not available.
- */
- #define DDERR_NOEMULATION MAKE_DDHRESULT( 565 )
- /*
- * region passed to Clipper::GetClipList is too small.
- */
- #define DDERR_REGIONTOOSMALL MAKE_DDHRESULT( 566 )
- /*
- * an attempt was made to set a clip list for a clipper objec that
- * is already monitoring an hwnd.
- */
- #define DDERR_CLIPPERISUSINGHWND MAKE_DDHRESULT( 567 )
- /*
- * No clipper object attached to surface object
- */
- #define DDERR_NOCLIPPERATTACHED MAKE_DDHRESULT( 568 )
- /*
- * Clipper notification requires an HWND or
- * no HWND has previously been set as the CooperativeLevel HWND.
- */
- #define DDERR_NOHWND MAKE_DDHRESULT( 569 )
- /*
- * HWND used by DirectDraw CooperativeLevel has been subclassed,
- * this prevents DirectDraw from restoring state.
- */
- #define DDERR_HWNDSUBCLASSED MAKE_DDHRESULT( 570 )
- /*
- * The CooperativeLevel HWND has already been set.
- * It can not be reset while the process has surfaces or palettes created.
- */
- #define DDERR_HWNDALREADYSET MAKE_DDHRESULT( 571 )
- /*
- * No palette object attached to this surface.
- */
- #define DDERR_NOPALETTEATTACHED MAKE_DDHRESULT( 572 )
- /*
- * No hardware support for 16 or 256 color palettes.
- */
- #define DDERR_NOPALETTEHW MAKE_DDHRESULT( 573 )
- /*
- * If a clipper object is attached to the source surface passed into a
- * BltFast call.
- */
- #define DDERR_BLTFASTCANTCLIP MAKE_DDHRESULT( 574 )
- /*
- * No blter.
- */
- #define DDERR_NOBLTHW MAKE_DDHRESULT( 575 )
- /*
- * No DirectDraw ROP hardware.
- */
- #define DDERR_NODDROPSHW MAKE_DDHRESULT( 576 )
- /*
- * returned when GetOverlayPosition is called on a hidden overlay
- */
- #define DDERR_OVERLAYNOTVISIBLE MAKE_DDHRESULT( 577 )
- /*
- * returned when GetOverlayPosition is called on a overlay that UpdateOverlay
- * has never been called on to establish a destionation.
- */
- #define DDERR_NOOVERLAYDEST MAKE_DDHRESULT( 578 )
- /*
- * returned when the position of the overlay on the destionation is no longer
- * legal for that destionation.
- */
- #define DDERR_INVALIDPOSITION MAKE_DDHRESULT( 579 )
- /*
- * returned when an overlay member is called for a non-overlay surface
- */
- #define DDERR_NOTAOVERLAYSURFACE MAKE_DDHRESULT( 580 )
- /*
- * An attempt was made to set the cooperative level when it was already
- * set to exclusive.
- */
- #define DDERR_EXCLUSIVEMODEALREADYSET MAKE_DDHRESULT( 581 )
- /*
- * An attempt has been made to flip a surface that is not flippable.
- */
- #define DDERR_NOTFLIPPABLE MAKE_DDHRESULT( 582 )
- /*
- * Can't duplicate primary & 3D surfaces, or surfaces that are implicitly
- * created.
- */
- #define DDERR_CANTDUPLICATE MAKE_DDHRESULT( 583 )
- /*
- * Surface was not locked. An attempt to unlock a surface that was not
- * locked at all, or by this process, has been attempted.
- */
- #define DDERR_NOTLOCKED MAKE_DDHRESULT( 584 )
- /*
- * Windows can not create any more DCs, or a DC was requested for a paltte-indexed
- * surface when the surface had no palette AND the display mode was not palette-indexed
- * (in this case DirectDraw cannot select a proper palette into the DC)
- */
- #define DDERR_CANTCREATEDC MAKE_DDHRESULT( 585 )
- /*
- * No DC was ever created for this surface.
- */
- #define DDERR_NODC MAKE_DDHRESULT( 586 )
- /*
- * This surface can not be restored because it was created in a different
- * mode.
- */
- #define DDERR_WRONGMODE MAKE_DDHRESULT( 587 )
- /*
- * This surface can not be restored because it is an implicitly created
- * surface.
- */
- #define DDERR_IMPLICITLYCREATED MAKE_DDHRESULT( 588 )
- /*
- * The surface being used is not a palette-based surface
- */
- #define DDERR_NOTPALETTIZED MAKE_DDHRESULT( 589 )
- /*
- * The display is currently in an unsupported mode
- */
- #define DDERR_UNSUPPORTEDMODE MAKE_DDHRESULT( 590 )
- /*
- * Operation could not be carried out because there is no mip-map
- * texture mapping hardware present or available.
- */
- #define DDERR_NOMIPMAPHW MAKE_DDHRESULT( 591 )
- /*
- * The requested action could not be performed because the surface was of
- * the wrong type.
- */
- #define DDERR_INVALIDSURFACETYPE MAKE_DDHRESULT( 592 )
- /*
- * Device does not support optimized surfaces, therefore no video memory optimized surfaces
- */
- #define DDERR_NOOPTIMIZEHW MAKE_DDHRESULT( 600 )
- /*
- * Surface is an optimized surface, but has not yet been allocated any memory
- */
- #define DDERR_NOTLOADED MAKE_DDHRESULT( 601 )
- /*
- * Attempt was made to create or set a device window without first setting
- * the focus window
- */
- #define DDERR_NOFOCUSWINDOW MAKE_DDHRESULT( 602 )
- /*
- * Attempt was made to set a palette on a mipmap sublevel
- */
- #define DDERR_NOTONMIPMAPSUBLEVEL MAKE_DDHRESULT( 603 )
- /*
- * A DC has already been returned for this surface. Only one DC can be
- * retrieved per surface.
- */
- #define DDERR_DCALREADYCREATED MAKE_DDHRESULT( 620 )
- /*
- * An attempt was made to allocate non-local video memory from a device
- * that does not support non-local video memory.
- */
- #define DDERR_NONONLOCALVIDMEM MAKE_DDHRESULT( 630 )
- /*
- * The attempt to page lock a surface failed.
- */
- #define DDERR_CANTPAGELOCK MAKE_DDHRESULT( 640 )
- /*
- * The attempt to page unlock a surface failed.
- */
- #define DDERR_CANTPAGEUNLOCK MAKE_DDHRESULT( 660 )
- /*
- * An attempt was made to page unlock a surface with no outstanding page locks.
- */
- #define DDERR_NOTPAGELOCKED MAKE_DDHRESULT( 680 )
- /*
- * There is more data available than the specified buffer size could hold
- */
- #define DDERR_MOREDATA MAKE_DDHRESULT( 690 )
- /*
- * The data has expired and is therefore no longer valid.
- */
- #define DDERR_EXPIRED MAKE_DDHRESULT( 691 )
- /*
- * The mode test has finished executing.
- */
- #define DDERR_TESTFINISHED MAKE_DDHRESULT( 692 )
- /*
- * The mode test has switched to a new mode.
- */
- #define DDERR_NEWMODE MAKE_DDHRESULT( 693 )
- /*
- * D3D has not yet been initialized.
- */
- #define DDERR_D3DNOTINITIALIZED MAKE_DDHRESULT( 694 )
- /*
- * The video port is not active
- */
- #define DDERR_VIDEONOTACTIVE MAKE_DDHRESULT( 695 )
- /*
- * The monitor does not have EDID data.
- */
- #define DDERR_NOMONITORINFORMATION MAKE_DDHRESULT( 696 )
- /*
- * The driver does not enumerate display mode refresh rates.
- */
- #define DDERR_NODRIVERSUPPORT MAKE_DDHRESULT( 697 )
- /*
- * Surfaces created by one direct draw device cannot be used directly by
- * another direct draw device.
- */
- #define DDERR_DEVICEDOESNTOWNSURFACE MAKE_DDHRESULT( 699 )
- /*
- * An attempt was made to invoke an interface member of a DirectDraw object
- * created by CoCreateInstance() before it was initialized.
- */
- #define DDERR_NOTINITIALIZED CO_E_NOTINITIALIZED
- /* Alpha bit depth constants */
- #ifdef __cplusplus
- };
- #endif
- #ifdef ENABLE_NAMELESS_UNION_PRAGMA
- #pragma warning(default:4201)
- #endif
- #endif //__DDRAW_INCLUDED__