|
|
/*******************************************************************
* * FILE: dciddi.h * * DESCRIPTION: definitions for MS/Intel-defined DCI interface * * Copyright (C) 1994-1999 Intel/Microsoft Corporation. All Rights Reserved. * *******************************************************************/
#ifndef _INC_DCIDDI
#define _INC_DCIDDI
#if _MSC_VER > 1000
#pragma once
#endif
#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 */ ULONG_PTR 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. */
typedefvoid(*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
|
