/******************************************************************* * * FILE: dciddi.h * * DESCRIPTION: definitions for MS/Intel-defined DCI interface * * Copyright (C) 1994 Intel/Microsoft Corporation. All Rights Reserved. * *******************************************************************/ #ifndef _INC_DCIDDI #define _INC_DCIDDI #ifdef __cplusplus extern "C" { #endif /* DCI Command Escapes */ #define DCICOMMAND 3075 #define DCI_VERSION 0x0100 #define DCICREATEPRIMARYSURFACE 1 #define DCICREATEOFFSCREENSURFACE 2 #define DCICREATEOVERLAYSURFACE 3 #define DCIENUMSURFACE 4 #define DCIESCAPE 5 /* DCI-Defined error codes */ #define DCI_OK 0 /* success */ /* Hard errors -- DCI will be unavailable */ #define DCI_FAIL_GENERIC -1 #define DCI_FAIL_UNSUPPORTEDVERSION -2 #define DCI_FAIL_INVALIDSURFACE -3 #define DCI_FAIL_UNSUPPORTED -4 /* Soft errors -- DCI may be available later */ #define DCI_ERR_CURRENTLYNOTAVAIL -5 #define DCI_ERR_INVALIDRECT -6 #define DCI_ERR_UNSUPPORTEDFORMAT -7 #define DCI_ERR_UNSUPPORTEDMASK -8 #define DCI_ERR_TOOBIGHEIGHT -9 #define DCI_ERR_TOOBIGWIDTH -10 #define DCI_ERR_TOOBIGSIZE -11 #define DCI_ERR_OUTOFMEMORY -12 #define DCI_ERR_INVALIDPOSITION -13 #define DCI_ERR_INVALIDSTRETCH -14 #define DCI_ERR_INVALIDCLIPLIST -15 #define DCI_ERR_SURFACEISOBSCURED -16 #define DCI_ERR_XALIGN -17 #define DCI_ERR_YALIGN -18 #define DCI_ERR_XYALIGN -19 #define DCI_ERR_WIDTHALIGN -20 #define DCI_ERR_HEIGHTALIGN -21 /* success messages -- DCI call succeeded, but specified item changed */ #define DCI_STATUS_POINTERCHANGED 1 #define DCI_STATUS_STRIDECHANGED 2 #define DCI_STATUS_FORMATCHANGED 4 #define DCI_STATUS_SURFACEINFOCHANGED 8 #define DCI_STATUS_CHROMAKEYCHANGED 16 #define DCI_STATUS_WASSTILLDRAWING 32 #define DCI_SUCCESS(error) (((DCIRVAL)error) >= 0) /* DCI Capability Flags */ #define DCI_SURFACE_TYPE 0x0000000F #define DCI_PRIMARY 0x00000000 #define DCI_OFFSCREEN 0x00000001 #define DCI_OVERLAY 0x00000002 #define DCI_VISIBLE 0x00000010 #define DCI_CHROMAKEY 0x00000020 #define DCI_1632_ACCESS 0x00000040 #define DCI_DWORDSIZE 0x00000080 #define DCI_DWORDALIGN 0x00000100 #define DCI_WRITEONLY 0x00000200 #define DCI_ASYNC 0x00000400 #define DCI_CAN_STRETCHX 0x00001000 #define DCI_CAN_STRETCHY 0x00002000 #define DCI_CAN_STRETCHXY (DCI_CAN_STRETCHX | DCI_CAN_STRETCHY) #define DCI_CAN_STRETCHXN 0x00004000 #define DCI_CAN_STRETCHYN 0x00008000 #define DCI_CAN_STRETCHXYN (DCI_CAN_STRETCHXN | DCI_CAN_STRETCHYN) #define DCI_CANOVERLAY 0x00010000 /* * Win32 RGNDATA structure. This will be used for cliplist info. passing. */ #if (WINVER < 0x0400) #ifndef RDH_RECTANGLES typedef struct tagRECTL { LONG left; LONG top; LONG right; LONG bottom; } RECTL; typedef RECTL* PRECTL; typedef RECTL NEAR* NPRECTL; typedef RECTL FAR* LPRECTL; typedef const RECTL FAR* LPCRECTL; #define RDH_RECTANGLES 0 typedef struct tagRGNDATAHEADER { DWORD dwSize; /* size of structure */ DWORD iType; /* Will be RDH_RECTANGLES */ DWORD nCount; /* # of clipping rectangles */ DWORD nRgnSize; /* size of buffer -- can be zero */ RECTL rcBound; /* bounding rectangle for region*/ } RGNDATAHEADER; typedef RGNDATAHEADER* PRGNDATAHEADER; typedef RGNDATAHEADER NEAR* NPRGNDATAHEADER; typedef RGNDATAHEADER FAR* LPRGNDATAHEADER; typedef const RGNDATAHEADER FAR* LPCRGNDATAHEADER; typedef struct tagRGNDATA { RGNDATAHEADER rdh; char Buffer[1]; } RGNDATA; typedef RGNDATA* PRGNDATA; typedef RGNDATA NEAR* NPRGNDATA; typedef RGNDATA FAR* LPRGNDATA; typedef const RGNDATA FAR* LPCRGNDATA; #endif #endif typedef int DCIRVAL; /* return for callbacks */ /************************************************************************** * input structures **************************************************************************/ /* * Used by a DCI client to provide input parameters for the * DCICREATEPRIMARYSURFACE escape. */ typedef struct _DCICMD { DWORD dwCommand; DWORD dwParam1; DWORD dwParam2; DWORD dwVersion; DWORD dwReserved; } DCICMD; /* * This structure is used by a DCI client to provide input parameters for * the DCICREATE... calls. The fields that are actually relevant differ for * each of the three calls. Details are in the DCI Spec chapter providing * the function specifications. */ typedef struct _DCICREATEINPUT { DCICMD cmd; /* common header structure */ DWORD dwCompression; /* format of surface to be created */ DWORD dwMask[3]; /* for nonstandard RGB (e.g. 5-6-5, RGB32) */ DWORD dwWidth; /* height of the surface to be created */ DWORD dwHeight; /* width of input surfaces */ DWORD dwDCICaps; /* capabilities of surface wanted */ DWORD dwBitCount; /* bit depth of format to be created */ LPVOID lpSurface; /* pointer to an associated surface */ } DCICREATEINPUT, FAR *LPDCICREATEINPUT; /************************************************************************** * surface info. structures **************************************************************************/ /* * This structure is used to return information about available support * during a DCIEnumSurface call. It is also used to create a primary * surface, and as a member of the larger structures returned by the * offscreen and overlay calls. */ typedef struct _DCISURFACEINFO { DWORD dwSize; /* size of structure */ DWORD dwDCICaps; /* capability flags (stretch, etc.) */ DWORD dwCompression; /* format of surface to be created */ DWORD dwMask[3]; /* for BI_BITMASK surfaces */ DWORD dwWidth; /* width of surface */ DWORD dwHeight; /* height of surface */ LONG lStride; /* distance in bytes betw. one pixel */ /* and the pixel directly below it */ DWORD dwBitCount; /* Bits per pixel for this dwCompression */ DWORD dwOffSurface; /* offset of surface pointer */ WORD wSelSurface; /* selector of surface pointer */ WORD wReserved; DWORD dwReserved1; /* reserved for provider */ DWORD dwReserved2; /* reserved for DCIMAN */ DWORD dwReserved3; /* reserved for future */ DCIRVAL (CALLBACK *BeginAccess) (LPVOID, LPRECT); /* BeginAccess callback */ void (CALLBACK *EndAccess) (LPVOID); /* EndAcess callback */ void (CALLBACK *DestroySurface) (LPVOID); /* Destroy surface callback */ } DCISURFACEINFO, FAR *LPDCISURFACEINFO; /* * This structure is used by a DCI client to provide input parameters for the * DCIEnumSurface call. */ typedef void (*ENUM_CALLBACK) ( LPDCISURFACEINFO lpSurfaceInfo, LPVOID lpContext ); typedef struct _DCIENUMINPUT { DCICMD cmd; /* common header structure */ RECT rSrc; /* source rect. for stretch */ RECT rDst; /* dest. rect. for stretch */ void (CALLBACK *EnumCallback)(LPDCISURFACEINFO, LPVOID); /* callback for supported formats */ LPVOID lpContext; } DCIENUMINPUT, FAR *LPDCIENUMINPUT; /* * This structure must be allocated and returned by the DCI provider in * response to a DCICREATEPRIMARYSURFACE call. */ typedef DCISURFACEINFO DCIPRIMARY, FAR *LPDCIPRIMARY; /* * This structure must be allocated and returned by the DCI provider in * response to a DCICREATEOFFSCREENSURFACE call. */ typedef struct _DCIOFFSCREEN { DCISURFACEINFO dciInfo; /* surface info */ DCIRVAL (CALLBACK *Draw) (LPVOID); /* copy to onscreen buffer */ DCIRVAL (CALLBACK *SetClipList) (LPVOID, LPRGNDATA); /* SetCliplist callback */ DCIRVAL (CALLBACK *SetDestination) (LPVOID, LPRECT, LPRECT); /* SetDestination callback */ } DCIOFFSCREEN, FAR *LPDCIOFFSCREEN; /* * This structure must be allocated and returned by the DCI provider in response * to a DCICREATEOVERLAYSURFACE call. */ typedef struct _DCIOVERLAY{ DCISURFACEINFO dciInfo; /* surface info */ DWORD dwChromakeyValue; /* chromakey color value */ DWORD dwChromakeyMask; /* specifies valid bits of value */ } DCIOVERLAY, FAR *LPDCIOVERLAY; /* DCI FOURCC def.s for extended DIB formats */ #ifndef YVU9 #define YVU9 mmioFOURCC('Y','V','U','9') #endif #ifndef Y411 #define Y411 mmioFOURCC('Y','4','1','1') #endif #ifndef YUY2 #define YUY2 mmioFOURCC('Y','U','Y','2') #endif #ifndef YVYU #define YVYU mmioFOURCC('Y','V','Y','U') #endif #ifndef UYVY #define UYVY mmioFOURCC('U','Y','V','Y') #endif #ifndef Y211 #define Y211 mmioFOURCC('Y','2','1','1') #endif #ifdef __cplusplus } #endif #endif // _INC_DCIDDI