415 lines
15 KiB
C
415 lines
15 KiB
C
/****************************************************************************/
|
|
/* */
|
|
/* MMDDK.H - Include file for Multimedia Device Development Kit */
|
|
/* */
|
|
/* Note: You must include the WINDOWS.H and MMSYSTEM.H header files */
|
|
/* before including this file. */
|
|
/* */
|
|
/* Copyright (c) 1990-1991, Microsoft Corp. All rights reserved. */
|
|
/* */
|
|
/****************************************************************************/
|
|
|
|
|
|
/* If defined, the following flags inhibit inclusion
|
|
* of the indicated items:
|
|
*
|
|
* MMNOMIDIDEV - MIDI support
|
|
* MMNOWAVEDEV - Waveform support
|
|
* MMNOAUXDEV - Auxiliary output support
|
|
* MMNOTIMERDEV - Timer support
|
|
* MMNOJOYDEV - Joystick support
|
|
* MMNOMCIDEV - MCI support
|
|
* MMNOTASKDEV - Task support
|
|
*/
|
|
#ifdef NOMIDIDEV /* ;Internal */
|
|
#define MMNOMIDIDEV /* ;Internal */
|
|
#endif /*ifdef NOMIDIDEV */ /* ;Internal */
|
|
#ifdef NOWAVEDEV /* ;Internal */
|
|
#define MMNOWAVEDEV /* ;Internal */
|
|
#endif /*ifdef NOWAVEDEV */ /* ;Internal */
|
|
#ifdef NOAUXDEV /* ;Internal */
|
|
#define MMNOAUXDEV /* ;Internal */
|
|
#endif /*ifdef NOAUXDEV */ /* ;Internal */
|
|
#ifdef NOTIMERDEV /* ;Internal */
|
|
#define MMNOTIMERDEV /* ;Internal */
|
|
#endif /*ifdef NOTIMERDEV */ /* ;Internal */
|
|
#ifdef NOJOYDEV /* ;Internal */
|
|
#define MMNOJOYDEV /* ;Internal */
|
|
#endif /*ifdef NOJOYDEV */ /* ;Internal */
|
|
#ifdef NOMCIDEV /* ;Internal */
|
|
#define MMNOMCIDEV /* ;Internal */
|
|
#endif /*ifdef NOMCIDEV */ /* ;Internal */
|
|
#ifdef NOTASKDEV /* ;Internal */
|
|
#define MMNOTASKDEV /* ;Internal */
|
|
#endif /*ifdef NOTASKDEV*/ /* ;Internal */
|
|
|
|
#ifndef _INC_MMDDK
|
|
#define _INC_MMDDK /* #defined if mmddk.h has been included */
|
|
|
|
#ifndef RC_INVOKED
|
|
#pragma pack(1) /* Assume byte packing throughout */
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" { /* Assume C declarations for C++ */
|
|
#endif /* __cplusplus */
|
|
|
|
/***************************************************************************
|
|
|
|
Helper functions for drivers
|
|
|
|
***************************************************************************/
|
|
|
|
#define DCB_NOSWITCH 0x0008 /* don't switch stacks for callback */
|
|
#define DCB_TYPEMASK 0x0007 /* callback type mask */
|
|
#define DCB_NULL 0x0000 /* unknown callback type */
|
|
|
|
/* flags for wFlags parameter of DriverCallback() */
|
|
#define DCB_WINDOW 0x0001 /* dwCallback is a HWND */
|
|
#define DCB_TASK 0x0002 /* dwCallback is a HTASK */
|
|
#define DCB_FUNCTION 0x0003 /* dwCallback is a FARPROC */
|
|
|
|
BOOL WINAPI DriverCallback(DWORD dwCallback, UINT uFlags,
|
|
HANDLE hDevice, UINT uMessage, DWORD dwUser, DWORD dwParam1, DWORD dwParam2);
|
|
void WINAPI StackEnter(void);
|
|
void WINAPI StackLeave(void);
|
|
|
|
/* generic prototype for audio device driver entry-point functions */
|
|
/* midMessage(), modMessage(), widMessage(), wodMessage(), auxMessage() */
|
|
typedef DWORD (CALLBACK SOUNDDEVMSGPROC)(UINT uDeviceID, UINT uMessage,
|
|
DWORD dwInstance, DWORD dwParam1, DWORD dwParam2);
|
|
typedef SOUNDDEVMSGPROC FAR *LPSOUNDDEVMSGPROC;
|
|
|
|
/* device ID for 386 AUTODMA VxD */
|
|
#define VADMAD_Device_ID 0X0444
|
|
|
|
#ifndef MMNOWAVEDEV
|
|
/****************************************************************************
|
|
|
|
Waveform device driver support
|
|
|
|
****************************************************************************/
|
|
|
|
/* maximum number of wave device drivers loaded */
|
|
#define MAXWAVEDRIVERS 10
|
|
|
|
|
|
/* waveform input and output device open information structure */
|
|
typedef struct waveopendesc_tag {
|
|
HWAVE hWave; /* handle */
|
|
const WAVEFORMAT FAR* lpFormat; /* format of wave data */
|
|
DWORD dwCallback; /* callback */
|
|
DWORD dwInstance; /* app's private instance information */
|
|
} WAVEOPENDESC;
|
|
typedef WAVEOPENDESC FAR *LPWAVEOPENDESC;
|
|
|
|
#define DRVM_USER 0x4000
|
|
|
|
/*
|
|
* Message sent by mmsystem to wodMessage(), widMessage(), modMessage(),
|
|
* and midMessage() when it initializes the wave and midi drivers
|
|
*/
|
|
|
|
#define DRVM_INIT 100
|
|
#define WODM_INIT DRVM_INIT
|
|
#define WIDM_INIT DRVM_INIT
|
|
#define MODM_INIT DRVM_INIT
|
|
#define MIDM_INIT DRVM_INIT
|
|
#define AUXM_INIT DRVM_INIT
|
|
|
|
/* messages sent to wodMessage() entry-point function */
|
|
#define WODM_GETNUMDEVS 3
|
|
#define WODM_GETDEVCAPS 4
|
|
#define WODM_OPEN 5
|
|
#define WODM_CLOSE 6
|
|
#define WODM_PREPARE 7
|
|
#define WODM_UNPREPARE 8
|
|
#define WODM_WRITE 9
|
|
#define WODM_PAUSE 10
|
|
#define WODM_RESTART 11
|
|
#define WODM_RESET 12
|
|
#define WODM_GETPOS 13
|
|
#define WODM_GETPITCH 14
|
|
#define WODM_SETPITCH 15
|
|
#define WODM_GETVOLUME 16
|
|
#define WODM_SETVOLUME 17
|
|
#define WODM_GETPLAYBACKRATE 18
|
|
#define WODM_SETPLAYBACKRATE 19
|
|
#define WODM_BREAKLOOP 20
|
|
|
|
/* messages sent to widMessage() entry-point function */
|
|
#define WIDM_GETNUMDEVS 50
|
|
#define WIDM_GETDEVCAPS 51
|
|
#define WIDM_OPEN 52
|
|
#define WIDM_CLOSE 53
|
|
#define WIDM_PREPARE 54
|
|
#define WIDM_UNPREPARE 55
|
|
#define WIDM_ADDBUFFER 56
|
|
#define WIDM_START 57
|
|
#define WIDM_STOP 58
|
|
#define WIDM_RESET 59
|
|
#define WIDM_GETPOS 60
|
|
|
|
#endif /*ifndef MMNOWAVEDEV */
|
|
|
|
|
|
#ifndef MMNOMIDIDEV
|
|
/****************************************************************************
|
|
|
|
MIDI device driver support
|
|
|
|
****************************************************************************/
|
|
|
|
/* maximum number of MIDI device drivers loaded */
|
|
#define MAXMIDIDRIVERS 10
|
|
|
|
/* MIDI input and output device open information structure */
|
|
typedef struct midiopendesc_tag {
|
|
HMIDI hMidi; /* handle */
|
|
DWORD dwCallback; /* callback */
|
|
DWORD dwInstance; /* app's private instance information */
|
|
} MIDIOPENDESC;
|
|
typedef MIDIOPENDESC FAR *LPMIDIOPENDESC;
|
|
|
|
/* messages sent to modMessage() entry-point function */
|
|
#define MODM_GETNUMDEVS 1
|
|
#define MODM_GETDEVCAPS 2
|
|
#define MODM_OPEN 3
|
|
#define MODM_CLOSE 4
|
|
#define MODM_PREPARE 5
|
|
#define MODM_UNPREPARE 6
|
|
#define MODM_DATA 7
|
|
#define MODM_LONGDATA 8
|
|
#define MODM_RESET 9
|
|
#define MODM_GETVOLUME 10
|
|
#define MODM_SETVOLUME 11
|
|
#define MODM_CACHEPATCHES 12
|
|
#define MODM_CACHEDRUMPATCHES 13
|
|
|
|
/* messages sent to midMessage() entry-point function */
|
|
#define MIDM_GETNUMDEVS 53
|
|
#define MIDM_GETDEVCAPS 54
|
|
#define MIDM_OPEN 55
|
|
#define MIDM_CLOSE 56
|
|
#define MIDM_PREPARE 57
|
|
#define MIDM_UNPREPARE 58
|
|
#define MIDM_ADDBUFFER 59
|
|
#define MIDM_START 60
|
|
#define MIDM_STOP 61
|
|
#define MIDM_RESET 62
|
|
|
|
#endif /*ifndef MMNOMIDIDEV */
|
|
|
|
|
|
#ifndef MMNOAUXDEV
|
|
/****************************************************************************
|
|
|
|
Auxiliary audio device driver support
|
|
|
|
****************************************************************************/
|
|
|
|
/* maximum number of auxiliary device drivers loaded */
|
|
#define MAXAUXDRIVERS 10
|
|
|
|
/* messages sent to auxMessage() entry-point function */
|
|
#define AUXDM_GETNUMDEVS 3
|
|
#define AUXDM_GETDEVCAPS 4
|
|
#define AUXDM_GETVOLUME 5
|
|
#define AUXDM_SETVOLUME 6
|
|
|
|
#endif /*ifndef MMNOAUXDEV */
|
|
|
|
|
|
#ifndef MMNOTIMERDEV
|
|
/****************************************************************************
|
|
|
|
Timer device driver support
|
|
|
|
****************************************************************************/
|
|
|
|
typedef struct timerevent_tag {
|
|
UINT wDelay; /* delay required */
|
|
UINT wResolution; /* resolution required */
|
|
LPTIMECALLBACK lpFunction; /* ptr to callback function */
|
|
DWORD dwUser; /* user DWORD */
|
|
UINT wFlags; /* defines how to program event */
|
|
} TIMEREVENT;
|
|
typedef TIMEREVENT FAR *LPTIMEREVENT;
|
|
|
|
/* messages sent to tddMessage() function */
|
|
#define TDD_KILLTIMEREVENT DRV_RESERVED+0 /* indices into a table of */
|
|
#define TDD_SETTIMEREVENT DRV_RESERVED+4 /* functions; thus offset by */
|
|
#define TDD_GETSYSTEMTIME DRV_RESERVED+8 /* four each time... */
|
|
#define TDD_GETDEVCAPS DRV_RESERVED+12 /* room for future expansion */
|
|
#define TDD_BEGINMINPERIOD DRV_RESERVED+16 /* room for future expansion */
|
|
#define TDD_ENDMINPERIOD DRV_RESERVED+20 /* room for future expansion */
|
|
|
|
#endif /*ifndef MMNOTIMERDEV */
|
|
|
|
|
|
#ifndef MMNOJOYDEV
|
|
/****************************************************************************
|
|
|
|
Joystick device driver support
|
|
|
|
****************************************************************************/
|
|
|
|
/* joystick calibration info structure */
|
|
typedef struct joycalibrate_tag {
|
|
UINT wXbase;
|
|
UINT wXdelta;
|
|
UINT wYbase;
|
|
UINT wYdelta;
|
|
UINT wZbase;
|
|
UINT wZdelta;
|
|
} JOYCALIBRATE;
|
|
typedef JOYCALIBRATE FAR *LPJOYCALIBRATE;
|
|
|
|
/* prototype for joystick message function */
|
|
typedef UINT (CALLBACK JOYDEVMSGPROC)(DWORD dwID, UINT uMessage, LPARAM lParam1, LPARAM lParam2);
|
|
typedef JOYDEVMSGPROC FAR *LPJOYDEVMSGPROC;
|
|
|
|
/* messages sent to joystick driver's DriverProc() function */
|
|
#define JDD_GETNUMDEVS DRV_RESERVED+0x0001
|
|
#define JDD_GETDEVCAPS DRV_RESERVED+0x0002
|
|
#define JDD_GETPOS DRV_RESERVED+0x0101
|
|
#define JDD_SETCALIBRATION DRV_RESERVED+0x0102
|
|
|
|
#endif /*ifndef MMNOJOYDEV */
|
|
|
|
|
|
#ifndef MMNOMCIDEV
|
|
/****************************************************************************
|
|
|
|
MCI device driver support
|
|
|
|
****************************************************************************/
|
|
|
|
/* internal MCI messages */
|
|
#define MCI_OPEN_DRIVER 0x0801
|
|
#define MCI_CLOSE_DRIVER 0x0802
|
|
|
|
#define MAKEMCIRESOURCE(wRet, wRes) MAKELRESULT((wRet), (wRes))
|
|
|
|
/* string return values only used with MAKEMCIRESOURCE */
|
|
#define MCI_FALSE (MCI_STRING_OFFSET + 19)
|
|
#define MCI_TRUE (MCI_STRING_OFFSET + 20)
|
|
|
|
/* resource string return values */
|
|
#define MCI_FORMAT_RETURN_BASE MCI_FORMAT_MILLISECONDS_S
|
|
#define MCI_FORMAT_MILLISECONDS_S (MCI_STRING_OFFSET + 21)
|
|
#define MCI_FORMAT_HMS_S (MCI_STRING_OFFSET + 22)
|
|
#define MCI_FORMAT_MSF_S (MCI_STRING_OFFSET + 23)
|
|
#define MCI_FORMAT_FRAMES_S (MCI_STRING_OFFSET + 24)
|
|
#define MCI_FORMAT_SMPTE_24_S (MCI_STRING_OFFSET + 25)
|
|
#define MCI_FORMAT_SMPTE_25_S (MCI_STRING_OFFSET + 26)
|
|
#define MCI_FORMAT_SMPTE_30_S (MCI_STRING_OFFSET + 27)
|
|
#define MCI_FORMAT_SMPTE_30DROP_S (MCI_STRING_OFFSET + 28)
|
|
#define MCI_FORMAT_BYTES_S (MCI_STRING_OFFSET + 29)
|
|
#define MCI_FORMAT_SAMPLES_S (MCI_STRING_OFFSET + 30)
|
|
#define MCI_FORMAT_TMSF_S (MCI_STRING_OFFSET + 31)
|
|
|
|
#define MCI_VD_FORMAT_TRACK_S (MCI_VD_OFFSET + 5)
|
|
|
|
#define WAVE_FORMAT_PCM_S (MCI_WAVE_OFFSET + 0)
|
|
#define WAVE_MAPPER_S (MCI_WAVE_OFFSET + 1)
|
|
|
|
#define MCI_SEQ_MAPPER_S (MCI_SEQ_OFFSET + 5)
|
|
#define MCI_SEQ_FILE_S (MCI_SEQ_OFFSET + 6)
|
|
#define MCI_SEQ_MIDI_S (MCI_SEQ_OFFSET + 7)
|
|
#define MCI_SEQ_SMPTE_S (MCI_SEQ_OFFSET + 8)
|
|
#define MCI_SEQ_FORMAT_SONGPTR_S (MCI_SEQ_OFFSET + 9)
|
|
#define MCI_SEQ_NONE_S (MCI_SEQ_OFFSET + 10)
|
|
#define MIDIMAPPER_S (MCI_SEQ_OFFSET + 11)
|
|
|
|
/* parameters for internal version of MCI_OPEN message sent from */
|
|
/* mciOpenDevice() to the driver */
|
|
typedef struct {
|
|
UINT wDeviceID; /* device ID */
|
|
LPCSTR lpstrParams; /* parameter string for entry in SYSTEM.INI */
|
|
UINT wCustomCommandTable; /* custom command table (0xFFFF if none) */
|
|
/* filled in by the driver */
|
|
UINT wType; /* driver type */
|
|
/* filled in by the driver */
|
|
} MCI_OPEN_DRIVER_PARMS;
|
|
typedef MCI_OPEN_DRIVER_PARMS FAR * LPMCI_OPEN_DRIVER_PARMS;
|
|
|
|
/* maximum length of an MCI device type */
|
|
#define MCI_MAX_DEVICE_TYPE_LENGTH 80
|
|
|
|
/* flags for mciSendCommandInternal() which direct mciSendString() how to */
|
|
/* interpret the return value */
|
|
#define MCI_RESOURCE_RETURNED 0x00010000 /* resource ID */
|
|
#define MCI_COLONIZED3_RETURN 0x00020000 /* colonized ID, 3 bytes data */
|
|
#define MCI_COLONIZED4_RETURN 0x00040000 /* colonized ID, 4 bytes data */
|
|
#define MCI_INTEGER_RETURNED 0x00080000 /* integer conversion needed */
|
|
#define MCI_RESOURCE_DRIVER 0x00100000 /* driver owns returned resource */
|
|
|
|
/* invalid command table ID */
|
|
#define MCI_NO_COMMAND_TABLE 0xFFFF
|
|
|
|
/* command table information type tags */
|
|
#define MCI_COMMAND_HEAD 0
|
|
#define MCI_STRING 1
|
|
#define MCI_INTEGER 2
|
|
#define MCI_END_COMMAND 3
|
|
#define MCI_RETURN 4
|
|
#define MCI_FLAG 5
|
|
#define MCI_END_COMMAND_LIST 6
|
|
#define MCI_RECT 7
|
|
#define MCI_CONSTANT 8
|
|
#define MCI_END_CONSTANT 9
|
|
|
|
/* function prototypes for MCI driver functions */
|
|
DWORD WINAPI mciGetDriverData(UINT uDeviceID);
|
|
BOOL WINAPI mciSetDriverData(UINT uDeviceID, DWORD dwData);
|
|
UINT WINAPI mciDriverYield(UINT uDeviceID);
|
|
BOOL WINAPI mciDriverNotify(HWND hwndCallback, UINT uDeviceID,
|
|
UINT uStatus);
|
|
UINT WINAPI mciLoadCommandResource(HINSTANCE hInstance,
|
|
LPCSTR lpResName, UINT uType);
|
|
BOOL WINAPI mciFreeCommandResource(UINT uTable);
|
|
|
|
#endif /*ifndef MMNOMCIDEV */
|
|
|
|
|
|
#ifndef MMNOTASKDEV
|
|
/*****************************************************************************
|
|
|
|
Task support
|
|
|
|
*****************************************************************************/
|
|
|
|
/* error return values */
|
|
#define TASKERR_NOTASKSUPPORT 1
|
|
#define TASKERR_OUTOFMEMORY 2
|
|
|
|
/* task support function prototypes */
|
|
#ifdef BUILDDLL /* ;Internal */
|
|
typedef void (FAR PASCAL TASKCALLBACK) (DWORD dwInst); /* ;Internal */
|
|
#else /*ifdef BUILDDLL*/ /* ;Internal */
|
|
typedef void (CALLBACK TASKCALLBACK) (DWORD dwInst);
|
|
#endif /*ifdef BUILDDLL*/ /* ;Internal */
|
|
|
|
typedef TASKCALLBACK FAR *LPTASKCALLBACK;
|
|
|
|
UINT WINAPI mmTaskCreate(LPTASKCALLBACK lpfnTaskProc, HTASK FAR * lphTask, DWORD dwInst);
|
|
UINT WINAPI mmTaskBlock(HTASK h);
|
|
BOOL WINAPI mmTaskSignal(HTASK h);
|
|
void WINAPI mmTaskYield(void);
|
|
HTASK WINAPI mmGetCurrentTask(void);
|
|
|
|
#endif /*ifndef MMNOTASKDEV */
|
|
|
|
#define MMDDKINC /* ;Internal */
|
|
|
|
#ifdef __cplusplus
|
|
} /* End of extern "C" { */
|
|
#endif /* __cplusplus */
|
|
|
|
#ifndef RC_INVOKED
|
|
#pragma pack() /* Revert to default packing */
|
|
#endif
|
|
|
|
#endif /* _INC_MMDDK */
|