288 lines
11 KiB
C
288 lines
11 KiB
C
|
/*******************************************************************
|
||
|
|
*
|
||
|
|
* 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.
|
||
|
|
*/
|
||
|
|
|
||
|
|
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
|