311 lines
10 KiB
C
311 lines
10 KiB
C
//==========================================================================;
|
|
//
|
|
// msacmdrv.h
|
|
//
|
|
// Copyright (c) 1992-1999 Microsoft Corporation. All Rights Reserved.
|
|
//
|
|
// Description:
|
|
// Audio Compression Manager Public Header File for Drivers
|
|
//
|
|
// History:
|
|
//
|
|
//==========================================================================;
|
|
|
|
#ifndef _INC_ACMDRV
|
|
#define _INC_ACMDRV /* #defined if msacmdrv.h has been included */
|
|
|
|
#if _MSC_VER > 1000
|
|
#pragma once
|
|
#endif
|
|
|
|
#if !defined(_INC_ACM)
|
|
#ifndef RC_INVOKED
|
|
#error MSACM.H to be included first
|
|
#endif
|
|
#endif
|
|
|
|
#include "pshpack1.h" /* Assume byte packing throughout */
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" { /* Assume C declarations for C++ */
|
|
#endif /* __cplusplus */
|
|
|
|
|
|
//- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
|
|
//
|
|
// ACM Driver Version:
|
|
//
|
|
// the version is a 32 bit number that is broken into three parts as
|
|
// follows:
|
|
//
|
|
// bits 24 - 31: 8 bit _major_ version number
|
|
// bits 16 - 23: 8 bit _minor_ version number
|
|
// bits 0 - 15: 16 bit build number
|
|
//
|
|
// this is then displayed as follows:
|
|
//
|
|
// bMajor = (BYTE)(dwVersion >> 24)
|
|
// bMinor = (BYTE)(dwVersion >> 16) &
|
|
// wBuild = LOWORD(dwVersion)
|
|
//
|
|
//- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
|
|
|
|
#define MAKE_ACM_VERSION(mjr, mnr, bld) (((long)(mjr)<<24)| \
|
|
((long)(mnr)<<16)| \
|
|
((long)bld))
|
|
|
|
|
|
#ifdef WIN32
|
|
//- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
|
|
//
|
|
// under WIN32 all drivers use unicode structures. these have already
|
|
// been #defined in MSACM.H. however, regardless of whether UNICODE is
|
|
// defined, we will define these structures as unicode structures for use
|
|
// in 32-bit drivers.
|
|
//
|
|
//- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
|
|
|
|
#undef ACMDRIVERDETAILS
|
|
#undef PACMDRIVERDETAILS
|
|
#undef LPACMDRIVERDETAILS
|
|
|
|
#undef ACMFORMATTAGDETAILS
|
|
#undef PACMFORMATTAGDETAILS
|
|
#undef LPACMFORMATTAGDETAILS
|
|
|
|
#undef ACMFORMATDETAILS
|
|
#undef PACMFORMATDETAILS
|
|
#undef LPACMFORMATDETAILS
|
|
|
|
#undef ACMFORMATCHOOSE
|
|
#undef PACMFORMATCHOOSE
|
|
#undef LPACMFORMATCHOOSE
|
|
|
|
#undef ACMFILTERTAGDETAILS
|
|
#undef PACMFILTERTAGDETAILS
|
|
#undef LPACMFILTERTAGDETAILS
|
|
|
|
#undef ACMFILTERDETAILS
|
|
#undef PACMFILTERDETAILS
|
|
#undef LPACMFILTERDETAILS
|
|
|
|
#undef ACMFILTERCHOOSE
|
|
#undef PACMFILTERCHOOSE
|
|
#undef LPACMFILTERCHOOSE
|
|
|
|
#define ACMDRIVERDETAILS ACMDRIVERDETAILSW
|
|
#define PACMDRIVERDETAILS PACMDRIVERDETAILSW
|
|
#define LPACMDRIVERDETAILS LPACMDRIVERDETAILSW
|
|
|
|
#define ACMFORMATTAGDETAILS ACMFORMATTAGDETAILSW
|
|
#define PACMFORMATTAGDETAILS PACMFORMATTAGDETAILSW
|
|
#define LPACMFORMATTAGDETAILS LPACMFORMATTAGDETAILSW
|
|
|
|
#define ACMFORMATDETAILS ACMFORMATDETAILSW
|
|
#define PACMFORMATDETAILS PACMFORMATDETAILSW
|
|
#define LPACMFORMATDETAILS LPACMFORMATDETAILSW
|
|
|
|
#define ACMFORMATCHOOSE ACMFORMATCHOOSEW
|
|
#define PACMFORMATCHOOSE PACMFORMATCHOOSEW
|
|
#define LPACMFORMATCHOOSE LPACMFORMATCHOOSEW
|
|
|
|
#define ACMFILTERTAGDETAILS ACMFILTERTAGDETAILSW
|
|
#define PACMFILTERTAGDETAILS PACMFILTERTAGDETAILSW
|
|
#define LPACMFILTERTAGDETAILS LPACMFILTERTAGDETAILSW
|
|
|
|
#define ACMFILTERDETAILS ACMFILTERDETAILSW
|
|
#define PACMFILTERDETAILS PACMFILTERDETAILSW
|
|
#define LPACMFILTERDETAILS LPACMFILTERDETAILSW
|
|
|
|
#define ACMFILTERCHOOSE ACMFILTERCHOOSEW
|
|
#define PACMFILTERCHOOSE PACMFILTERCHOOSEW
|
|
#define LPACMFILTERCHOOSE LPACMFILTERCHOOSEW
|
|
|
|
#endif
|
|
|
|
//
|
|
//
|
|
//
|
|
//
|
|
//
|
|
#define ACMDRVOPENDESC_SECTIONNAME_CHARS
|
|
|
|
#ifdef _WIN32
|
|
typedef struct tACMDRVOPENDESCA
|
|
{
|
|
DWORD cbStruct; // sizeof(ACMDRVOPENDESC)
|
|
FOURCC fccType; // 'audc'
|
|
FOURCC fccComp; // sub-type (not used--must be 0)
|
|
DWORD dwVersion; // current version of ACM opening you
|
|
DWORD dwFlags; //
|
|
DWORD dwError; // result from DRV_OPEN request
|
|
LPCSTR pszSectionName; // see DRVCONFIGINFO.lpszDCISectionName
|
|
LPCSTR pszAliasName; // see DRVCONFIGINFO.lpszDCIAliasName
|
|
DWORD dnDevNode; // devnode id for pnp drivers.
|
|
|
|
} ACMDRVOPENDESCA, *PACMDRVOPENDESCA, FAR *LPACMDRVOPENDESCA;
|
|
|
|
typedef struct tACMDRVOPENDESCW
|
|
{
|
|
DWORD cbStruct; // sizeof(ACMDRVOPENDESC)
|
|
FOURCC fccType; // 'audc'
|
|
FOURCC fccComp; // sub-type (not used--must be 0)
|
|
DWORD dwVersion; // current version of ACM opening you
|
|
DWORD dwFlags; //
|
|
DWORD dwError; // result from DRV_OPEN request
|
|
LPCWSTR pszSectionName; // see DRVCONFIGINFO.lpszDCISectionName
|
|
LPCWSTR pszAliasName; // see DRVCONFIGINFO.lpszDCIAliasName
|
|
DWORD dnDevNode; // devnode id for pnp drivers.
|
|
|
|
} ACMDRVOPENDESCW, *PACMDRVOPENDESCW, FAR *LPACMDRVOPENDESCW;
|
|
|
|
#define ACMDRVOPENDESC ACMDRVOPENDESCW
|
|
#define PACMDRVOPENDESC PACMDRVOPENDESCW
|
|
#define LPACMDRVOPENDESC LPACMDRVOPENDESCW
|
|
#else
|
|
typedef struct tACMDRVOPENDESC
|
|
{
|
|
DWORD cbStruct; // sizeof(ACMDRVOPENDESC)
|
|
FOURCC fccType; // 'audc'
|
|
FOURCC fccComp; // sub-type (not used--must be 0)
|
|
DWORD dwVersion; // current version of ACM opening you
|
|
DWORD dwFlags; //
|
|
DWORD dwError; // result from DRV_OPEN request
|
|
LPCSTR pszSectionName; // see DRVCONFIGINFO.lpszDCISectionName
|
|
LPCSTR pszAliasName; // see DRVCONFIGINFO.lpszDCIAliasName
|
|
DWORD dnDevNode; // devnode id for pnp drivers.
|
|
|
|
} ACMDRVOPENDESC, *PACMDRVOPENDESC, FAR *LPACMDRVOPENDESC;
|
|
#endif
|
|
|
|
|
|
//
|
|
//
|
|
//
|
|
//
|
|
//
|
|
typedef struct tACMDRVSTREAMINSTANCE
|
|
{
|
|
DWORD cbStruct;
|
|
LPWAVEFORMATEX pwfxSrc;
|
|
LPWAVEFORMATEX pwfxDst;
|
|
LPWAVEFILTER pwfltr;
|
|
DWORD_PTR dwCallback;
|
|
DWORD_PTR dwInstance;
|
|
DWORD fdwOpen;
|
|
DWORD fdwDriver;
|
|
DWORD_PTR dwDriver;
|
|
HACMSTREAM has;
|
|
|
|
} ACMDRVSTREAMINSTANCE, *PACMDRVSTREAMINSTANCE, FAR *LPACMDRVSTREAMINSTANCE;
|
|
|
|
|
|
//
|
|
// NOTE! this structure must match the ACMSTREAMHEADER in msacm.h but
|
|
// defines more information for the driver writing convenience
|
|
//
|
|
typedef struct tACMDRVSTREAMHEADER FAR *LPACMDRVSTREAMHEADER;
|
|
typedef struct tACMDRVSTREAMHEADER
|
|
{
|
|
DWORD cbStruct;
|
|
DWORD fdwStatus;
|
|
DWORD_PTR dwUser;
|
|
LPBYTE pbSrc;
|
|
DWORD cbSrcLength;
|
|
DWORD cbSrcLengthUsed;
|
|
DWORD_PTR dwSrcUser;
|
|
LPBYTE pbDst;
|
|
DWORD cbDstLength;
|
|
DWORD cbDstLengthUsed;
|
|
DWORD_PTR dwDstUser;
|
|
|
|
DWORD fdwConvert; // flags passed from convert func
|
|
LPACMDRVSTREAMHEADER padshNext; // for async driver queueing
|
|
DWORD fdwDriver; // driver instance flags
|
|
DWORD_PTR dwDriver; // driver instance data
|
|
|
|
//
|
|
// all remaining fields are used by the ACM for bookkeeping purposes.
|
|
// an ACM driver should never use these fields (though than can be
|
|
// helpful for debugging)--note that the meaning of these fields
|
|
// may change, so do NOT rely on them in shipping code.
|
|
//
|
|
DWORD fdwPrepared;
|
|
DWORD_PTR dwPrepared;
|
|
LPBYTE pbPreparedSrc;
|
|
DWORD cbPreparedSrcLength;
|
|
LPBYTE pbPreparedDst;
|
|
DWORD cbPreparedDstLength;
|
|
|
|
} ACMDRVSTREAMHEADER, *PACMDRVSTREAMHEADER;
|
|
|
|
|
|
//
|
|
// structure for ACMDM_STREAM_SIZE message
|
|
//
|
|
//
|
|
typedef struct tACMDRVSTREAMSIZE
|
|
{
|
|
DWORD cbStruct;
|
|
DWORD fdwSize;
|
|
DWORD cbSrcLength;
|
|
DWORD cbDstLength;
|
|
|
|
} ACMDRVSTREAMSIZE, *PACMDRVSTREAMSIZE, FAR *LPACMDRVSTREAMSIZE;
|
|
|
|
|
|
|
|
//
|
|
// structure containing the information for the ACMDM_FORMAT_SUGGEST message
|
|
//
|
|
//
|
|
typedef struct tACMDRVFORMATSUGGEST
|
|
{
|
|
DWORD cbStruct; // sizeof(ACMDRVFORMATSUGGEST)
|
|
DWORD fdwSuggest; // Suggest flags
|
|
LPWAVEFORMATEX pwfxSrc; // Source Format
|
|
DWORD cbwfxSrc; // Source Size
|
|
LPWAVEFORMATEX pwfxDst; // Dest format
|
|
DWORD cbwfxDst; // Dest Size
|
|
|
|
} ACMDRVFORMATSUGGEST, *PACMDRVFORMATSUGGEST, FAR *LPACMDRVFORMATSUGGEST;
|
|
|
|
//- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
|
|
//
|
|
// ACM Driver Messages
|
|
//
|
|
//
|
|
//
|
|
//- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
|
|
|
|
#define ACMDM_DRIVER_NOTIFY (ACMDM_BASE + 1)
|
|
#define ACMDM_DRIVER_DETAILS (ACMDM_BASE + 10)
|
|
|
|
#define ACMDM_HARDWARE_WAVE_CAPS_INPUT (ACMDM_BASE + 20)
|
|
#define ACMDM_HARDWARE_WAVE_CAPS_OUTPUT (ACMDM_BASE + 21)
|
|
|
|
#define ACMDM_FORMATTAG_DETAILS (ACMDM_BASE + 25)
|
|
#define ACMDM_FORMAT_DETAILS (ACMDM_BASE + 26)
|
|
#define ACMDM_FORMAT_SUGGEST (ACMDM_BASE + 27)
|
|
|
|
#define ACMDM_FILTERTAG_DETAILS (ACMDM_BASE + 50)
|
|
#define ACMDM_FILTER_DETAILS (ACMDM_BASE + 51)
|
|
|
|
#define ACMDM_STREAM_OPEN (ACMDM_BASE + 76)
|
|
#define ACMDM_STREAM_CLOSE (ACMDM_BASE + 77)
|
|
#define ACMDM_STREAM_SIZE (ACMDM_BASE + 78)
|
|
#define ACMDM_STREAM_CONVERT (ACMDM_BASE + 79)
|
|
#define ACMDM_STREAM_RESET (ACMDM_BASE + 80)
|
|
#define ACMDM_STREAM_PREPARE (ACMDM_BASE + 81)
|
|
#define ACMDM_STREAM_UNPREPARE (ACMDM_BASE + 82)
|
|
#define ACMDM_STREAM_UPDATE (ACMDM_BASE + 83)
|
|
|
|
|
|
#include "poppack.h" /* Revert to default packing */
|
|
|
|
#ifdef __cplusplus
|
|
} /* End of extern "C" { */
|
|
#endif /* __cplusplus */
|
|
|
|
#endif /* _INC_ACMDRV */
|