diff options
Diffstat (limited to 'public/sdk/inc/dciddi.h')
| -rw-r--r-- | public/sdk/inc/dciddi.h | 283 |
1 files changed, 283 insertions, 0 deletions
diff --git a/public/sdk/inc/dciddi.h b/public/sdk/inc/dciddi.h new file mode 100644 index 000000000..841298887 --- /dev/null +++ b/public/sdk/inc/dciddi.h @@ -0,0 +1,283 @@ +/******************************************************************* + * + * 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 |