开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 游戏 > 模拟服务器 > 查看源码
MSAcm.h
资源名称：SwordOnline.rar　[点击查看]
上传用户：dzyhzl
上传日期：2019-04-29
资源大小：56270k
文件大小：57k
源码类别：

模拟服务器

开发平台：

C/C++

MSAcm.h：源码内容
  1. //==========================================================================;
  2. //
  3. //  msacm.h
  4. //
  5. //  Copyright (c) 1992-1999 Microsoft Corporation.  All Rights Reserved.
  6. //
  7. //  Description:
  8. //      Audio Compression Manager Public Header File
  9. //
  10. //  History:
  11. //
  12. //==========================================================================;
  14. #ifndef _INC_ACM
  15. #define _INC_ACM        /* #defined if msacm.h has been included */
  17. #if _MSC_VER > 1000
  18. #pragma once
  19. #endif
  21. #if !defined(_INC_MMREG) || (_INC_MMREG < 142)
  22. #ifndef RC_INVOKED
  23. #error MMREG.H version 142 or greater to be included first
  24. #endif
  25. #endif
  27. #if defined(WIN32) && !defined(_WIN32)
  28. #ifndef RC_INVOKED
  29. #pragma message("MSACM.H: defining _WIN32 because application defined WIN32")
  30. #endif
  31. #define _WIN32
  32. #endif
  34. #if defined(UNICODE) && !defined(_UNICODE)
  35. #ifndef RC_INVOKED
  36. #pragma message("MSACM.H: defining _UNICODE because application defined UNICODE")
  37. #endif
  38. #define _UNICODE
  39. #endif
  41. #include "pshpack1.h"   /* Assume byte packing throughout */
  43. #ifdef __cplusplus
  44. extern "C" {            /* Assume C declarations for C++ */
  45. #endif  /* __cplusplus */
  48. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  49. //
  50. //
  51. //
  52. //
  53. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  55. #ifndef DRV_MAPPER_PREFERRED_INPUT_GET
  56. #define DRV_MAPPER_PREFERRED_INPUT_GET  (DRV_USER + 0)
  57. #endif
  59. #ifndef DRV_MAPPER_PREFERRED_OUTPUT_GET
  60. #define DRV_MAPPER_PREFERRED_OUTPUT_GET (DRV_USER + 2)
  61. #endif
  64. #ifndef DRVM_MAPPER_STATUS
  65. #define DRVM_MAPPER             0x2000
  66. #define DRVM_MAPPER_STATUS      (DRVM_MAPPER+0)
  67. #endif
  69. #ifndef WIDM_MAPPER_STATUS
  70. #define WIDM_MAPPER_STATUS              (DRVM_MAPPER_STATUS + 0)
  71. #define WAVEIN_MAPPER_STATUS_DEVICE     0
  72. #define WAVEIN_MAPPER_STATUS_MAPPED     1
  73. #define WAVEIN_MAPPER_STATUS_FORMAT     2
  74. #endif
  76. #ifndef WODM_MAPPER_STATUS
  77. #define WODM_MAPPER_STATUS              (DRVM_MAPPER_STATUS + 0)
  78. #define WAVEOUT_MAPPER_STATUS_DEVICE    0
  79. #define WAVEOUT_MAPPER_STATUS_MAPPED    1
  80. #define WAVEOUT_MAPPER_STATUS_FORMAT    2
  81. #endif
  84. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  85. //
  86. //
  87. //
  88. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  90. #ifdef _WIN32
  91.     #define ACMAPI              WINAPI
  92. #else
  93. #ifdef _WINDLL
  94.     #define ACMAPI              _far _pascal _loadds
  95. #else
  96.     #define ACMAPI              _far _pascal
  97. #endif
  98. #endif
  101. //--------------------------------------------------------------------------;
  102. //
  103. //  ACM General API's and Defines
  104. //
  105. //
  106. //
  107. //
  108. //--------------------------------------------------------------------------;
  110. //
  111. //  there are four types of 'handles' used by the ACM. the first three
  112. //  are unique types that define specific objects:
  113. //
  114. //  HACMDRIVERID: used to _identify_ an ACM driver. this identifier can be
  115. //  used to _open_ the driver for querying details, etc about the driver.
  116. //
  117. //  HACMDRIVER: used to manage a driver (codec, filter, etc). this handle
  118. //  is much like a handle to other media drivers--you use it to send
  119. //  messages to the converter, query for capabilities, etc.
  120. //
  121. //  HACMSTREAM: used to manage a 'stream' (conversion channel) with the
  122. //  ACM. you use a stream handle to convert data from one format/type
  123. //  to another--much like dealing with a file handle.
  124. //
  125. //
  126. //  the fourth handle type is a generic type used on ACM functions that
  127. //  can accept two or more of the above handle types (for example the
  128. //  acmMetrics and acmDriverID functions).
  129. //
  130. //  HACMOBJ: used to identify ACM objects. this handle is used on functions
  131. //  that can accept two or more ACM handle types.
  132. //
  133. DECLARE_HANDLE(HACMDRIVERID);
  134. typedef HACMDRIVERID       *PHACMDRIVERID;
  135. typedef HACMDRIVERID   FAR *LPHACMDRIVERID;
  137. DECLARE_HANDLE(HACMDRIVER);
  138. typedef HACMDRIVER         *PHACMDRIVER;
  139. typedef HACMDRIVER     FAR *LPHACMDRIVER;
  141. DECLARE_HANDLE(HACMSTREAM);
  142. typedef HACMSTREAM         *PHACMSTREAM;
  143. typedef HACMSTREAM     FAR *LPHACMSTREAM;
  145. DECLARE_HANDLE(HACMOBJ);
  146. typedef HACMOBJ            *PHACMOBJ;
  147. typedef HACMOBJ        FAR *LPHACMOBJ;
  151. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  152. //
  153. //  ACM Error Codes
  154. //
  155. //  Note that these error codes are specific errors that apply to the ACM
  156. //  directly--general errors are defined as MMSYSERR_*.
  157. //
  158. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  160. #ifndef _MMRESULT_
  161. #define _MMRESULT_
  162. typedef UINT                MMRESULT;
  163. #endif
  165. #define ACMERR_BASE         (512)
  166. #define ACMERR_NOTPOSSIBLE  (ACMERR_BASE + 0)
  167. #define ACMERR_BUSY         (ACMERR_BASE + 1)
  168. #define ACMERR_UNPREPARED   (ACMERR_BASE + 2)
  169. #define ACMERR_CANCELED     (ACMERR_BASE + 3)
  172. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  173. //
  174. //  ACM Window Messages
  175. //
  176. //  These window messages are sent by the ACM or ACM drivers to notify
  177. //  applications of events.
  178. //
  179. //  Note that these window message numbers will also be defined in
  180. //  mmsystem.
  181. //
  182. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  184. #define MM_ACM_OPEN         (MM_STREAM_OPEN)  // conversion callback messages
  185. #define MM_ACM_CLOSE        (MM_STREAM_CLOSE)
  186. #define MM_ACM_DONE         (MM_STREAM_DONE)
  189. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  190. //
  191. //  acmGetVersion()
  192. //
  193. //  the ACM version is a 32 bit number that is broken into three parts as
  194. //  follows:
  195. //
  196. //      bits 24 - 31:   8 bit _major_ version number
  197. //      bits 16 - 23:   8 bit _minor_ version number
  198. //      bits  0 - 15:   16 bit build number
  199. //
  200. //  this is then displayed as follows:
  201. //
  202. //      bMajor = (BYTE)(dwVersion >> 24)
  203. //      bMinor = (BYTE)(dwVersion >> 16) &
  204. //      wBuild = LOWORD(dwVersion)
  205. //
  206. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  208. DWORD ACMAPI acmGetVersion
  209. (
  210.     void
  211. );
  214. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  215. //
  216. //  acmMetrics()
  217. //
  218. //
  219. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  221. MMRESULT ACMAPI acmMetrics
  222. (
  223.     HACMOBJ                 hao,
  224.     UINT                    uMetric,
  225.     LPVOID                  pMetric
  226. );
  228. #define ACM_METRIC_COUNT_DRIVERS            1
  229. #define ACM_METRIC_COUNT_CODECS             2
  230. #define ACM_METRIC_COUNT_CONVERTERS         3
  231. #define ACM_METRIC_COUNT_FILTERS            4
  232. #define ACM_METRIC_COUNT_DISABLED           5
  233. #define ACM_METRIC_COUNT_HARDWARE           6
  234. #define ACM_METRIC_COUNT_LOCAL_DRIVERS      20
  235. #define ACM_METRIC_COUNT_LOCAL_CODECS       21
  236. #define ACM_METRIC_COUNT_LOCAL_CONVERTERS   22
  237. #define ACM_METRIC_COUNT_LOCAL_FILTERS      23
  238. #define ACM_METRIC_COUNT_LOCAL_DISABLED     24
  239. #define ACM_METRIC_HARDWARE_WAVE_INPUT      30
  240. #define ACM_METRIC_HARDWARE_WAVE_OUTPUT     31
  241. #define ACM_METRIC_MAX_SIZE_FORMAT          50
  242. #define ACM_METRIC_MAX_SIZE_FILTER          51
  243. #define ACM_METRIC_DRIVER_SUPPORT           100
  244. #define ACM_METRIC_DRIVER_PRIORITY          101
  247. //--------------------------------------------------------------------------;
  248. //
  249. //  ACM Drivers
  250. //
  251. //
  252. //
  253. //
  254. //--------------------------------------------------------------------------;
  256. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  257. //
  258. //  acmDriverEnum()
  259. //
  260. //
  261. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  263. typedef BOOL (CALLBACK *ACMDRIVERENUMCB)
  264. (
  265.     HACMDRIVERID            hadid,
  266.     DWORD_PTR               dwInstance,
  267.     DWORD                   fdwSupport
  268. );
  270. MMRESULT ACMAPI acmDriverEnum
  271. (
  272.     ACMDRIVERENUMCB         fnCallback,
  273.     DWORD_PTR               dwInstance,
  274.     DWORD                   fdwEnum
  275. );
  277. #define ACM_DRIVERENUMF_NOLOCAL     0x40000000L
  278. #define ACM_DRIVERENUMF_DISABLED    0x80000000L
  283. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  284. //
  285. //  acmDriverID()
  286. //
  287. //
  288. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  290. MMRESULT ACMAPI acmDriverID
  291. (
  292.     HACMOBJ                 hao,
  293.     LPHACMDRIVERID          phadid,
  294.     DWORD                   fdwDriverID
  295. );
  298. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  299. //
  300. //  acmDriverAdd()
  301. //
  302. //
  303. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  305. #ifdef _WIN32
  306. MMRESULT ACMAPI acmDriverAddA
  307. (
  308.     LPHACMDRIVERID          phadid,
  309.     HINSTANCE               hinstModule,
  310.     LPARAM                  lParam,
  311.     DWORD                   dwPriority,
  312.     DWORD                   fdwAdd
  313. );
  315. MMRESULT ACMAPI acmDriverAddW
  316. (
  317.     LPHACMDRIVERID          phadid,
  318.     HINSTANCE               hinstModule,
  319.     LPARAM                  lParam,
  320.     DWORD                   dwPriority,
  321.     DWORD                   fdwAdd
  322. );
  324. #ifdef _UNICODE
  325. #define acmDriverAdd        acmDriverAddW
  326. #else
  327. #define acmDriverAdd        acmDriverAddA
  328. #endif
  329. #else
  330. MMRESULT ACMAPI acmDriverAdd
  331. (
  332.     LPHACMDRIVERID          phadid,
  333.     HINSTANCE               hinstModule,
  334.     LPARAM                  lParam,
  335.     DWORD                   dwPriority,
  336.     DWORD                   fdwAdd
  337. );
  338. #endif
  340. #define ACM_DRIVERADDF_FUNCTION     0x00000003L  // lParam is a procedure
  341. #define ACM_DRIVERADDF_NOTIFYHWND   0x00000004L  // lParam is notify hwnd
  342. #define ACM_DRIVERADDF_TYPEMASK     0x00000007L  // driver type mask
  343. #define ACM_DRIVERADDF_LOCAL        0x00000000L  // is local to current task
  344. #define ACM_DRIVERADDF_GLOBAL       0x00000008L  // is global
  348. //
  349. //  prototype for ACM driver procedures that are installed as _functions_
  350. //  or _notifations_ instead of as a standalone installable driver.
  351. //
  352. typedef LRESULT (CALLBACK *ACMDRIVERPROC)(DWORD_PTR, HACMDRIVERID, UINT, LPARAM, LPARAM);
  353. typedef ACMDRIVERPROC FAR *LPACMDRIVERPROC;
  355. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  356. //
  357. //  acmDriverRemove()
  358. //
  359. //
  360. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  362. MMRESULT ACMAPI acmDriverRemove
  363. (
  364.     HACMDRIVERID            hadid,
  365.     DWORD                   fdwRemove
  366. );
  369. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  370. //
  371. //  acmDriverOpen()
  372. //
  373. //
  374. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  376. MMRESULT ACMAPI acmDriverOpen
  377. (
  378.     LPHACMDRIVER            phad,
  379.     HACMDRIVERID            hadid,
  380.     DWORD                   fdwOpen
  381. );
  384. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  385. //
  386. //  acmDriverClose()
  387. //
  388. //
  389. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  391. MMRESULT ACMAPI acmDriverClose
  392. (
  393.     HACMDRIVER              had,
  394.     DWORD                   fdwClose
  395. );
  398. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  399. //
  400. //  acmDriverMessage()
  401. //
  402. //
  403. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  405. LRESULT ACMAPI acmDriverMessage
  406. (
  407.     HACMDRIVER              had,
  408.     UINT                    uMsg,
  409.     LPARAM                  lParam1,
  410.     LPARAM                  lParam2
  411. );
  414. //
  415. //
  416. //
  417. //
  418. #define ACMDM_USER                  (DRV_USER + 0x0000)
  419. #define ACMDM_RESERVED_LOW          (DRV_USER + 0x2000)
  420. #define ACMDM_RESERVED_HIGH         (DRV_USER + 0x2FFF)
  422. #define ACMDM_BASE                  ACMDM_RESERVED_LOW
  424. #define ACMDM_DRIVER_ABOUT          (ACMDM_BASE + 11)
  427. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  428. //
  429. //  acmDriverPriority
  430. //
  431. //
  432. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  434. MMRESULT ACMAPI acmDriverPriority
  435. (
  436.     HACMDRIVERID            hadid,
  437.     DWORD                   dwPriority,
  438.     DWORD                   fdwPriority
  439. );
  442. #define ACM_DRIVERPRIORITYF_ENABLE      0x00000001L
  443. #define ACM_DRIVERPRIORITYF_DISABLE     0x00000002L
  444. #define ACM_DRIVERPRIORITYF_ABLEMASK    0x00000003L
  445. #define ACM_DRIVERPRIORITYF_BEGIN       0x00010000L
  446. #define ACM_DRIVERPRIORITYF_END         0x00020000L
  447. #define ACM_DRIVERPRIORITYF_DEFERMASK   0x00030000L
  452. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  453. //
  454. //  acmDriverDetails()
  455. //
  456. //
  457. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  459. //
  460. //  ACMDRIVERDETAILS
  461. //
  462. //  the ACMDRIVERDETAILS structure is used to get various capabilities from
  463. //  an ACM driver (codec, converter, filter).
  464. //
  465. #define ACMDRIVERDETAILS_SHORTNAME_CHARS    32
  466. #define ACMDRIVERDETAILS_LONGNAME_CHARS     128
  467. #define ACMDRIVERDETAILS_COPYRIGHT_CHARS    80
  468. #define ACMDRIVERDETAILS_LICENSING_CHARS    128
  469. #define ACMDRIVERDETAILS_FEATURES_CHARS     512
  471. #ifdef _WIN32
  472. typedef struct tACMDRIVERDETAILSA
  473. {
  474.     DWORD           cbStruct;           // number of valid bytes in structure
  476.     FOURCC          fccType;            // compressor type 'audc'
  477.     FOURCC          fccComp;            // sub-type (not used; reserved)
  479.     WORD            wMid;               // manufacturer id
  480.     WORD            wPid;               // product id
  482.     DWORD           vdwACM;             // version of the ACM *compiled* for
  483.     DWORD           vdwDriver;          // version of the driver
  485.     DWORD           fdwSupport;         // misc. support flags
  486.     DWORD           cFormatTags;        // total unique format tags supported
  487.     DWORD           cFilterTags;        // total unique filter tags supported
  489.     HICON           hicon;              // handle to custom icon
  491.     char            szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS];
  492.     char            szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS];
  493.     char            szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS];
  494.     char            szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS];
  495.     char            szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS];
  497. } ACMDRIVERDETAILSA, *PACMDRIVERDETAILSA, FAR *LPACMDRIVERDETAILSA;
  499. typedef struct tACMDRIVERDETAILSW
  500. {
  501.     DWORD           cbStruct;           // number of valid bytes in structure
  503.     FOURCC          fccType;            // compressor type 'audc'
  504.     FOURCC          fccComp;            // sub-type (not used; reserved)
  506.     WORD            wMid;               // manufacturer id
  507.     WORD            wPid;               // product id
  509.     DWORD           vdwACM;             // version of the ACM *compiled* for
  510.     DWORD           vdwDriver;          // version of the driver
  512.     DWORD           fdwSupport;         // misc. support flags
  513.     DWORD           cFormatTags;        // total unique format tags supported
  514.     DWORD           cFilterTags;        // total unique filter tags supported
  516.     HICON           hicon;              // handle to custom icon
  518.     WCHAR           szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS];
  519.     WCHAR           szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS];
  520.     WCHAR           szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS];
  521.     WCHAR           szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS];
  522.     WCHAR           szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS];
  524. } ACMDRIVERDETAILSW, *PACMDRIVERDETAILSW, FAR *LPACMDRIVERDETAILSW;
  526. #ifdef _UNICODE
  527. #define ACMDRIVERDETAILS        ACMDRIVERDETAILSW
  528. #define PACMDRIVERDETAILS       PACMDRIVERDETAILSW
  529. #define LPACMDRIVERDETAILS      LPACMDRIVERDETAILSW
  530. #else
  531. #define ACMDRIVERDETAILS        ACMDRIVERDETAILSA
  532. #define PACMDRIVERDETAILS       PACMDRIVERDETAILSA
  533. #define LPACMDRIVERDETAILS      LPACMDRIVERDETAILSA
  534. #endif
  535. #else
  536. typedef struct tACMDRIVERDETAILS
  537. {
  538.     DWORD           cbStruct;           // number of valid bytes in structure
  540.     FOURCC          fccType;            // compressor type 'audc'
  541.     FOURCC          fccComp;            // sub-type (not used; reserved)
  543.     WORD            wMid;               // manufacturer id
  544.     WORD            wPid;               // product id
  546.     DWORD           vdwACM;             // version of the ACM *compiled* for
  547.     DWORD           vdwDriver;          // version of the driver
  549.     DWORD           fdwSupport;         // misc. support flags
  550.     DWORD           cFormatTags;        // total unique format tags supported
  551.     DWORD           cFilterTags;        // total unique filter tags supported
  553.     HICON           hicon;              // handle to custom icon
  555.     char            szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS];
  556.     char            szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS];
  557.     char            szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS];
  558.     char            szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS];
  559.     char            szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS];
  561. } ACMDRIVERDETAILS, *PACMDRIVERDETAILS, FAR *LPACMDRIVERDETAILS;
  562. #endif
  564. //
  565. //  ACMDRIVERDETAILS.fccType
  566. //
  567. //  ACMDRIVERDETAILS_FCCTYPE_AUDIOCODEC: the FOURCC used in the fccType
  568. //  field of the ACMDRIVERDETAILS structure to specify that this is an ACM
  569. //  codec designed for audio.
  570. //
  571. //
  572. //  ACMDRIVERDETAILS.fccComp
  573. //
  574. //  ACMDRIVERDETAILS_FCCCOMP_UNDEFINED: the FOURCC used in the fccComp
  575. //  field of the ACMDRIVERDETAILS structure. this is currently an unused
  576. //  field.
  577. //
  578. #define ACMDRIVERDETAILS_FCCTYPE_AUDIOCODEC mmioFOURCC('a', 'u', 'd', 'c')
  579. #define ACMDRIVERDETAILS_FCCCOMP_UNDEFINED  mmioFOURCC('', '', '', '')
  582. //
  583. //  the following flags are used to specify the type of conversion(s) that
  584. //  the converter/codec/filter supports. these are placed in the fdwSupport
  585. //  field of the ACMDRIVERDETAILS structure. note that a converter can
  586. //  support one or more of these flags in any combination.
  587. //
  588. //  ACMDRIVERDETAILS_SUPPORTF_CODEC: this flag is set if the driver supports
  589. //  conversions from one format tag to another format tag. for example, if a
  590. //  converter compresses WAVE_FORMAT_PCM to WAVE_FORMAT_ADPCM, then this bit
  591. //  should be set.
  592. //
  593. //  ACMDRIVERDETAILS_SUPPORTF_CONVERTER: this flags is set if the driver
  594. //  supports conversions on the same format tag. as an example, the PCM
  595. //  converter that is built into the ACM sets this bit (and only this bit)
  596. //  because it converts only PCM formats (bits, sample rate).
  597. //
  598. //  ACMDRIVERDETAILS_SUPPORTF_FILTER: this flag is set if the driver supports
  599. //  transformations on a single format. for example, a converter that changed
  600. //  the 'volume' of PCM data would set this bit. 'echo' and 'reverb' are
  601. //  also filter types.
  602. //
  603. //  ACMDRIVERDETAILS_SUPPORTF_HARDWARE: this flag is set if the driver supports
  604. //  hardware input and/or output through a waveform device.
  605. //
  606. //  ACMDRIVERDETAILS_SUPPORTF_ASYNC: this flag is set if the driver supports
  607. //  async conversions.
  608. //
  609. //
  610. //  ACMDRIVERDETAILS_SUPPORTF_LOCAL: this flag is set _by the ACM_ if a
  611. //  driver has been installed local to the current task. this flag is also
  612. //  set in the fdwSupport argument to the enumeration callback function
  613. //  for drivers.
  614. //
  615. //  ACMDRIVERDETAILS_SUPPORTF_DISABLED: this flag is set _by the ACM_ if a
  616. //  driver has been disabled. this flag is also passed set in the fdwSupport
  617. //  argument to the enumeration callback function for drivers.
  618. //
  619. #define ACMDRIVERDETAILS_SUPPORTF_CODEC     0x00000001L
  620. #define ACMDRIVERDETAILS_SUPPORTF_CONVERTER 0x00000002L
  621. #define ACMDRIVERDETAILS_SUPPORTF_FILTER    0x00000004L
  622. #define ACMDRIVERDETAILS_SUPPORTF_HARDWARE  0x00000008L
  623. #define ACMDRIVERDETAILS_SUPPORTF_ASYNC     0x00000010L
  624. #define ACMDRIVERDETAILS_SUPPORTF_LOCAL     0x40000000L
  625. #define ACMDRIVERDETAILS_SUPPORTF_DISABLED  0x80000000L
  628. #ifdef _WIN32
  629. MMRESULT ACMAPI acmDriverDetailsA
  630. (
  631.     HACMDRIVERID            hadid,
  632.     LPACMDRIVERDETAILSA     padd,
  633.     DWORD                   fdwDetails
  634. );
  636. MMRESULT ACMAPI acmDriverDetailsW
  637. (
  638.     HACMDRIVERID            hadid,
  639.     LPACMDRIVERDETAILSW     padd,
  640.     DWORD                   fdwDetails
  641. );
  643. #ifdef _UNICODE
  644. #define acmDriverDetails    acmDriverDetailsW
  645. #else
  646. #define acmDriverDetails    acmDriverDetailsA
  647. #endif
  648. #else
  649. MMRESULT ACMAPI acmDriverDetails
  650. (
  651.     HACMDRIVERID            hadid,
  652.     LPACMDRIVERDETAILS      padd,
  653.     DWORD                   fdwDetails
  654. );
  655. #endif
  659. //--------------------------------------------------------------------------;
  660. //
  661. //  ACM Format Tags
  662. //
  663. //
  664. //
  665. //
  666. //--------------------------------------------------------------------------;
  668. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  669. //
  670. //  acmFormatTagDetails()
  671. //
  672. //
  673. //
  674. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  676. #define ACMFORMATTAGDETAILS_FORMATTAG_CHARS 48
  678. #ifdef _WIN32
  679. typedef struct tACMFORMATTAGDETAILSA
  680. {
  681.     DWORD           cbStruct;
  682.     DWORD           dwFormatTagIndex;
  683.     DWORD           dwFormatTag;
  684.     DWORD           cbFormatSize;
  685.     DWORD           fdwSupport;
  686.     DWORD           cStandardFormats;
  687.     char            szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS];
  689. } ACMFORMATTAGDETAILSA, *PACMFORMATTAGDETAILSA, FAR *LPACMFORMATTAGDETAILSA;
  691. typedef struct tACMFORMATTAGDETAILSW
  692. {
  693.     DWORD           cbStruct;
  694.     DWORD           dwFormatTagIndex;
  695.     DWORD           dwFormatTag;
  696.     DWORD           cbFormatSize;
  697.     DWORD           fdwSupport;
  698.     DWORD           cStandardFormats;
  699.     WCHAR           szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS];
  701. } ACMFORMATTAGDETAILSW, *PACMFORMATTAGDETAILSW, FAR *LPACMFORMATTAGDETAILSW;
  703. #ifdef _UNICODE
  704. #define ACMFORMATTAGDETAILS     ACMFORMATTAGDETAILSW
  705. #define PACMFORMATTAGDETAILS    PACMFORMATTAGDETAILSW
  706. #define LPACMFORMATTAGDETAILS   LPACMFORMATTAGDETAILSW
  707. #else
  708. #define ACMFORMATTAGDETAILS     ACMFORMATTAGDETAILSA
  709. #define PACMFORMATTAGDETAILS    PACMFORMATTAGDETAILSA
  710. #define LPACMFORMATTAGDETAILS   LPACMFORMATTAGDETAILSA
  711. #endif
  712. #else
  713. typedef struct tACMFORMATTAGDETAILS
  714. {
  715.     DWORD           cbStruct;
  716.     DWORD           dwFormatTagIndex;
  717.     DWORD           dwFormatTag;
  718.     DWORD           cbFormatSize;
  719.     DWORD           fdwSupport;
  720.     DWORD           cStandardFormats;
  721.     char            szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS];
  723. } ACMFORMATTAGDETAILS, *PACMFORMATTAGDETAILS, FAR *LPACMFORMATTAGDETAILS;
  724. #endif
  726. #ifdef _WIN32
  727. MMRESULT ACMAPI acmFormatTagDetailsA
  728. (
  729.     HACMDRIVER              had,
  730.     LPACMFORMATTAGDETAILSA  paftd,
  731.     DWORD                   fdwDetails
  732. );
  734. MMRESULT ACMAPI acmFormatTagDetailsW
  735. (
  736.     HACMDRIVER              had,
  737.     LPACMFORMATTAGDETAILSW  paftd,
  738.     DWORD                   fdwDetails
  739. );
  741. #ifdef _UNICODE
  742. #define acmFormatTagDetails     acmFormatTagDetailsW
  743. #else
  744. #define acmFormatTagDetails     acmFormatTagDetailsA
  745. #endif
  746. #else
  747. MMRESULT ACMAPI acmFormatTagDetails
  748. (
  749.     HACMDRIVER              had,
  750.     LPACMFORMATTAGDETAILS   paftd,
  751.     DWORD                   fdwDetails
  752. );
  753. #endif
  755. #define ACM_FORMATTAGDETAILSF_INDEX         0x00000000L
  756. #define ACM_FORMATTAGDETAILSF_FORMATTAG     0x00000001L
  757. #define ACM_FORMATTAGDETAILSF_LARGESTSIZE   0x00000002L
  758. #define ACM_FORMATTAGDETAILSF_QUERYMASK     0x0000000FL
  761. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  762. //
  763. //  acmFormatTagEnum()
  764. //
  765. //
  766. //
  767. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  769. #ifdef _WIN32
  770. typedef BOOL (CALLBACK *ACMFORMATTAGENUMCBA)
  771. (
  772.     HACMDRIVERID            hadid,
  773.     LPACMFORMATTAGDETAILSA  paftd,
  774.     DWORD_PTR               dwInstance,
  775.     DWORD                   fdwSupport
  776. );
  778. MMRESULT ACMAPI acmFormatTagEnumA
  779. (
  780.     HACMDRIVER              had,
  781.     LPACMFORMATTAGDETAILSA  paftd,
  782.     ACMFORMATTAGENUMCBA     fnCallback,
  783.     DWORD_PTR               dwInstance,
  784.     DWORD                   fdwEnum
  785. );
  786. typedef BOOL (CALLBACK *ACMFORMATTAGENUMCBW)
  787. (
  788.     HACMDRIVERID            hadid,
  789.     LPACMFORMATTAGDETAILSW  paftd,
  790.     DWORD_PTR               dwInstance,
  791.     DWORD                   fdwSupport
  792. );
  794. MMRESULT ACMAPI acmFormatTagEnumW
  795. (
  796.     HACMDRIVER              had,
  797.     LPACMFORMATTAGDETAILSW  paftd,
  798.     ACMFORMATTAGENUMCBW     fnCallback,
  799.     DWORD_PTR               dwInstance,
  800.     DWORD                   fdwEnum
  801. );
  803. #ifdef _UNICODE
  804. #define ACMFORMATTAGENUMCB      ACMFORMATTAGENUMCBW
  805. #define acmFormatTagEnum        acmFormatTagEnumW
  806. #else
  807. #define ACMFORMATTAGENUMCB      ACMFORMATTAGENUMCBA
  808. #define acmFormatTagEnum        acmFormatTagEnumA
  809. #endif
  810. #else
  811. typedef BOOL (CALLBACK *ACMFORMATTAGENUMCB)
  812. (
  813.     HACMDRIVERID            hadid,
  814.     LPACMFORMATTAGDETAILS   paftd,
  815.     DWORD_PTR               dwInstance,
  816.     DWORD                   fdwSupport
  817. );
  819. MMRESULT ACMAPI acmFormatTagEnum
  820. (
  821.     HACMDRIVER              had,
  822.     LPACMFORMATTAGDETAILS   paftd,
  823.     ACMFORMATTAGENUMCB      fnCallback,
  824.     DWORD_PTR               dwInstance,
  825.     DWORD                   fdwEnum
  826. );
  827. #endif
  830. //--------------------------------------------------------------------------;
  831. //
  832. //  ACM Formats
  833. //
  834. //
  835. //
  836. //
  837. //--------------------------------------------------------------------------;
  839. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  840. //
  841. //  acmFormatDetails()
  842. //
  843. //
  844. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  846. #define ACMFORMATDETAILS_FORMAT_CHARS   128
  848. #ifdef _WIN32
  849. typedef struct tACMFORMATDETAILSA
  850. {
  851.     DWORD           cbStruct;
  852.     DWORD           dwFormatIndex;
  853.     DWORD           dwFormatTag;
  854.     DWORD           fdwSupport;
  855.     LPWAVEFORMATEX  pwfx;
  856.     DWORD           cbwfx;
  857.     char            szFormat[ACMFORMATDETAILS_FORMAT_CHARS];
  859. } ACMFORMATDETAILSA, *PACMFORMATDETAILSA, FAR *LPACMFORMATDETAILSA;
  861. typedef struct tACMFORMATDETAILSW
  862. {
  863.     DWORD           cbStruct;
  864.     DWORD           dwFormatIndex;
  865.     DWORD           dwFormatTag;
  866.     DWORD           fdwSupport;
  867.     LPWAVEFORMATEX  pwfx;
  868.     DWORD           cbwfx;
  869.     WCHAR           szFormat[ACMFORMATDETAILS_FORMAT_CHARS];
  871. } ACMFORMATDETAILSW, *PACMFORMATDETAILSW, FAR *LPACMFORMATDETAILSW;
  873. #ifdef _UNICODE
  874. #define ACMFORMATDETAILS    ACMFORMATDETAILSW
  875. #define PACMFORMATDETAILS   PACMFORMATDETAILSW
  876. #define LPACMFORMATDETAILS  LPACMFORMATDETAILSW
  877. #else
  878. #define ACMFORMATDETAILS    ACMFORMATDETAILSA
  879. #define PACMFORMATDETAILS   PACMFORMATDETAILSA
  880. #define LPACMFORMATDETAILS  LPACMFORMATDETAILSA
  881. #endif
  882. #else
  883. typedef struct tACMFORMATDETAILS
  884. {
  885.     DWORD           cbStruct;
  886.     DWORD           dwFormatIndex;
  887.     DWORD           dwFormatTag;
  888.     DWORD           fdwSupport;
  889.     LPWAVEFORMATEX  pwfx;
  890.     DWORD           cbwfx;
  891.     char            szFormat[ACMFORMATDETAILS_FORMAT_CHARS];
  893. } ACMFORMATDETAILS, *PACMFORMATDETAILS, FAR *LPACMFORMATDETAILS;
  894. #endif
  897. #ifdef _WIN32
  898. MMRESULT ACMAPI acmFormatDetailsA
  899. (
  900.     HACMDRIVER              had,
  901.     LPACMFORMATDETAILSA     pafd,
  902.     DWORD                   fdwDetails
  903. );
  905. MMRESULT ACMAPI acmFormatDetailsW
  906. (
  907.     HACMDRIVER              had,
  908.     LPACMFORMATDETAILSW     pafd,
  909.     DWORD                   fdwDetails
  910. );
  912. #ifdef _UNICODE
  913. #define acmFormatDetails    acmFormatDetailsW
  914. #else
  915. #define acmFormatDetails    acmFormatDetailsA
  916. #endif
  917. #else
  918. MMRESULT ACMAPI acmFormatDetails
  919. (
  920.     HACMDRIVER              had,
  921.     LPACMFORMATDETAILS      pafd,
  922.     DWORD                   fdwDetails
  923. );
  924. #endif
  926. #define ACM_FORMATDETAILSF_INDEX        0x00000000L
  927. #define ACM_FORMATDETAILSF_FORMAT       0x00000001L
  928. #define ACM_FORMATDETAILSF_QUERYMASK    0x0000000FL
  931. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  932. //
  933. //  acmFormatEnum()
  934. //
  935. //
  936. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  938. #ifdef _WIN32
  939. typedef BOOL (CALLBACK *ACMFORMATENUMCBA)
  940. (
  941.     HACMDRIVERID            hadid,
  942.     LPACMFORMATDETAILSA     pafd,
  943.     DWORD_PTR               dwInstance,
  944.     DWORD                   fdwSupport
  945. );
  947. MMRESULT ACMAPI acmFormatEnumA
  948. (
  949.     HACMDRIVER              had,
  950.     LPACMFORMATDETAILSA     pafd,
  951.     ACMFORMATENUMCBA        fnCallback,
  952.     DWORD_PTR               dwInstance,
  953.     DWORD                   fdwEnum
  954. );
  956. typedef BOOL (CALLBACK *ACMFORMATENUMCBW)
  957. (
  958.     HACMDRIVERID            hadid,
  959.     LPACMFORMATDETAILSW     pafd,
  960.     DWORD_PTR               dwInstance,
  961.     DWORD                   fdwSupport
  962. );
  964. MMRESULT ACMAPI acmFormatEnumW
  965. (
  966.     HACMDRIVER              had,
  967.     LPACMFORMATDETAILSW     pafd,
  968.     ACMFORMATENUMCBW        fnCallback,
  969.     DWORD_PTR               dwInstance,
  970.     DWORD                   fdwEnum
  971. );
  973. #ifdef _UNICODE
  974. #define ACMFORMATENUMCB     ACMFORMATENUMCBW
  975. #define acmFormatEnum       acmFormatEnumW
  976. #else
  977. #define ACMFORMATENUMCB     ACMFORMATENUMCBA
  978. #define acmFormatEnum       acmFormatEnumA
  979. #endif
  980. #else
  981. typedef BOOL (CALLBACK *ACMFORMATENUMCB)
  982. (
  983.     HACMDRIVERID            hadid,
  984.     LPACMFORMATDETAILS      pafd,
  985.     DWORD_PTR               dwInstance,
  986.     DWORD                   fdwSupport
  987. );
  989. MMRESULT ACMAPI acmFormatEnum
  990. (
  991.     HACMDRIVER              had,
  992.     LPACMFORMATDETAILS      pafd,
  993.     ACMFORMATENUMCB         fnCallback,
  994.     DWORD_PTR               dwInstance,
  995.     DWORD                   fdwEnum
  996. );
  997. #endif
  999. #define ACM_FORMATENUMF_WFORMATTAG       0x00010000L
  1000. #define ACM_FORMATENUMF_NCHANNELS        0x00020000L
  1001. #define ACM_FORMATENUMF_NSAMPLESPERSEC   0x00040000L
  1002. #define ACM_FORMATENUMF_WBITSPERSAMPLE   0x00080000L
  1003. #define ACM_FORMATENUMF_CONVERT          0x00100000L
  1004. #define ACM_FORMATENUMF_SUGGEST          0x00200000L
  1005. #define ACM_FORMATENUMF_HARDWARE         0x00400000L
  1006. #define ACM_FORMATENUMF_INPUT            0x00800000L
  1007. #define ACM_FORMATENUMF_OUTPUT           0x01000000L
  1009. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1010. //
  1011. //  acmFormatSuggest()
  1012. //
  1013. //
  1014. //
  1015. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1017. MMRESULT ACMAPI acmFormatSuggest
  1018. (
  1019.     HACMDRIVER          had,
  1020.     LPWAVEFORMATEX      pwfxSrc,
  1021.     LPWAVEFORMATEX      pwfxDst,
  1022.     DWORD               cbwfxDst,
  1023.     DWORD               fdwSuggest
  1024. );
  1026. #define ACM_FORMATSUGGESTF_WFORMATTAG       0x00010000L
  1027. #define ACM_FORMATSUGGESTF_NCHANNELS        0x00020000L
  1028. #define ACM_FORMATSUGGESTF_NSAMPLESPERSEC   0x00040000L
  1029. #define ACM_FORMATSUGGESTF_WBITSPERSAMPLE   0x00080000L
  1031. #define ACM_FORMATSUGGESTF_TYPEMASK         0x00FF0000L
  1033. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1034. //
  1035. //  acmFormatChoose()
  1036. //
  1037. //
  1038. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1040. #ifdef _WIN32
  1041. #define ACMHELPMSGSTRINGA       "acmchoose_help"
  1042. #define ACMHELPMSGSTRINGW       L"acmchoose_help"
  1043. #define ACMHELPMSGCONTEXTMENUA  "acmchoose_contextmenu"
  1044. #define ACMHELPMSGCONTEXTMENUW  L"acmchoose_contextmenu"
  1045. #define ACMHELPMSGCONTEXTHELPA  "acmchoose_contexthelp"
  1046. #define ACMHELPMSGCONTEXTHELPW  L"acmchoose_contexthelp"
  1047. #ifdef _UNICODE
  1048. #define ACMHELPMSGSTRING        ACMHELPMSGSTRINGW
  1049. #define ACMHELPMSGCONTEXTMENU   ACMHELPMSGCONTEXTMENUW
  1050. #define ACMHELPMSGCONTEXTHELP   ACMHELPMSGCONTEXTHELPW
  1051. #else
  1052. #define ACMHELPMSGSTRING        ACMHELPMSGSTRINGA
  1053. #define ACMHELPMSGCONTEXTMENU   ACMHELPMSGCONTEXTMENUA
  1054. #define ACMHELPMSGCONTEXTHELP   ACMHELPMSGCONTEXTHELPA
  1055. #endif
  1056. #else
  1057. #define ACMHELPMSGSTRING        "acmchoose_help"
  1058. #define ACMHELPMSGCONTEXTMENU   "acmchoose_contextmenu"
  1059. #define ACMHELPMSGCONTEXTHELP   "acmchoose_contexthelp"
  1060. #endif
  1062. //
  1063. //  MM_ACM_FORMATCHOOSE is sent to hook callbacks by the Format Chooser
  1064. //  Dialog...
  1065. //
  1066. #define MM_ACM_FORMATCHOOSE             (0x8000)
  1068. #define FORMATCHOOSE_MESSAGE            0
  1069. #define FORMATCHOOSE_FORMATTAG_VERIFY   (FORMATCHOOSE_MESSAGE+0)
  1070. #define FORMATCHOOSE_FORMAT_VERIFY      (FORMATCHOOSE_MESSAGE+1)
  1071. #define FORMATCHOOSE_CUSTOM_VERIFY      (FORMATCHOOSE_MESSAGE+2)
  1073. #ifdef _WIN32
  1074. typedef UINT (CALLBACK *ACMFORMATCHOOSEHOOKPROCA)
  1075. (
  1076.     HWND                    hwnd,
  1077.     UINT                    uMsg,
  1078.     WPARAM                  wParam,
  1079.     LPARAM                  lParam
  1080. );
  1082. typedef UINT (CALLBACK *ACMFORMATCHOOSEHOOKPROCW)
  1083. (
  1084.     HWND                    hwnd,
  1085.     UINT                    uMsg,
  1086.     WPARAM                  wParam,
  1087.     LPARAM                  lParam
  1088. );
  1090. #ifdef _UNICODE
  1091. #define ACMFORMATCHOOSEHOOKPROC     ACMFORMATCHOOSEHOOKPROCW
  1092. #else
  1093. #define ACMFORMATCHOOSEHOOKPROC     ACMFORMATCHOOSEHOOKPROCA
  1094. #endif
  1095. #else
  1096. typedef UINT (CALLBACK *ACMFORMATCHOOSEHOOKPROC)
  1097. (
  1098.     HWND                    hwnd,
  1099.     UINT                    uMsg,
  1100.     WPARAM                  wParam,
  1101.     LPARAM                  lParam
  1102. );
  1103. #endif
  1105. //
  1106. //
  1107. //
  1108. //
  1109. #ifdef _WIN32
  1110. typedef struct tACMFORMATCHOOSEA
  1111. {
  1112.     DWORD           cbStruct;           // sizeof(ACMFORMATCHOOSE)
  1113.     DWORD           fdwStyle;           // chooser style flags
  1115.     HWND            hwndOwner;          // caller's window handle
  1117.     LPWAVEFORMATEX  pwfx;               // ptr to wfx buf to receive choice
  1118.     DWORD           cbwfx;              // size of mem buf for pwfx
  1119.     LPCSTR          pszTitle;           // dialog box title bar
  1121.     char            szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS];
  1122.     char            szFormat[ACMFORMATDETAILS_FORMAT_CHARS];
  1124.     LPSTR           pszName;            // custom name selection
  1125.     DWORD           cchName;            // size in chars of mem buf for pszName
  1127.     DWORD           fdwEnum;            // format enumeration restrictions
  1128.     LPWAVEFORMATEX  pwfxEnum;           // format describing restrictions
  1130.     HINSTANCE       hInstance;          // app instance containing dlg template
  1131.     LPCSTR          pszTemplateName;    // custom template name
  1132.     LPARAM          lCustData;          // data passed to hook fn.
  1133.     ACMFORMATCHOOSEHOOKPROCA pfnHook;   // ptr to hook function
  1135. } ACMFORMATCHOOSEA, *PACMFORMATCHOOSEA, FAR *LPACMFORMATCHOOSEA;
  1137. typedef struct tACMFORMATCHOOSEW
  1138. {
  1139.     DWORD           cbStruct;           // sizeof(ACMFORMATCHOOSE)
  1140.     DWORD           fdwStyle;           // chooser style flags
  1142.     HWND            hwndOwner;          // caller's window handle
  1144.     LPWAVEFORMATEX  pwfx;               // ptr to wfx buf to receive choice
  1145.     DWORD           cbwfx;              // size of mem buf for pwfx
  1146.     LPCWSTR         pszTitle;           // dialog box title bar
  1148.     WCHAR           szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS];
  1149.     WCHAR           szFormat[ACMFORMATDETAILS_FORMAT_CHARS];
  1151.     LPWSTR          pszName;            // custom name selection
  1152.     DWORD           cchName;            // size in chars of mem buf for pszName
  1154.     DWORD           fdwEnum;            // format enumeration restrictions
  1155.     LPWAVEFORMATEX  pwfxEnum;           // format describing restrictions
  1157.     HINSTANCE       hInstance;          // app instance containing dlg template
  1158.     LPCWSTR         pszTemplateName;    // custom template name
  1159.     LPARAM          lCustData;          // data passed to hook fn.
  1160.     ACMFORMATCHOOSEHOOKPROCW pfnHook;   // ptr to hook function
  1162. } ACMFORMATCHOOSEW, *PACMFORMATCHOOSEW, FAR *LPACMFORMATCHOOSEW;
  1164. #ifdef _UNICODE
  1165. #define ACMFORMATCHOOSE     ACMFORMATCHOOSEW
  1166. #define PACMFORMATCHOOSE    PACMFORMATCHOOSEW
  1167. #define LPACMFORMATCHOOSE   LPACMFORMATCHOOSEW
  1168. #else
  1169. #define ACMFORMATCHOOSE     ACMFORMATCHOOSEA
  1170. #define PACMFORMATCHOOSE    PACMFORMATCHOOSEA
  1171. #define LPACMFORMATCHOOSE   LPACMFORMATCHOOSEA
  1172. #endif
  1173. #else
  1174. typedef struct tACMFORMATCHOOSE
  1175. {
  1176.     DWORD           cbStruct;           // sizeof(ACMFORMATCHOOSE)
  1177.     DWORD           fdwStyle;           // chooser style flags
  1179.     HWND            hwndOwner;          // caller's window handle
  1181.     LPWAVEFORMATEX  pwfx;               // ptr to wfx buf to receive choice
  1182.     DWORD           cbwfx;              // size of mem buf for pwfx
  1183.     LPCSTR          pszTitle;           // dialog box title bar
  1185.     char            szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS];
  1186.     char            szFormat[ACMFORMATDETAILS_FORMAT_CHARS];
  1188.     LPSTR           pszName;            // custom name selection
  1189.     DWORD           cchName;            // size in chars of mem buf for pszName
  1191.     DWORD           fdwEnum;            // format enumeration restrictions
  1192.     LPWAVEFORMATEX  pwfxEnum;           // format describing restrictions
  1194.     HINSTANCE       hInstance;          // app instance containing dlg template
  1195.     LPCSTR          pszTemplateName;    // custom template name
  1196.     LPARAM          lCustData;          // data passed to hook fn.
  1197.     ACMFORMATCHOOSEHOOKPROC pfnHook;    // ptr to hook function
  1199. } ACMFORMATCHOOSE, *PACMFORMATCHOOSE, FAR *LPACMFORMATCHOOSE;
  1200. #endif
  1202. //
  1203. //  ACMFORMATCHOOSE.fdwStyle
  1204. //
  1205. //
  1206. //
  1207. #define ACMFORMATCHOOSE_STYLEF_SHOWHELP              0x00000004L
  1208. #define ACMFORMATCHOOSE_STYLEF_ENABLEHOOK            0x00000008L
  1209. #define ACMFORMATCHOOSE_STYLEF_ENABLETEMPLATE        0x00000010L
  1210. #define ACMFORMATCHOOSE_STYLEF_ENABLETEMPLATEHANDLE  0x00000020L
  1211. #define ACMFORMATCHOOSE_STYLEF_INITTOWFXSTRUCT       0x00000040L
  1212. #define ACMFORMATCHOOSE_STYLEF_CONTEXTHELP           0x00000080L
  1214. #ifdef _WIN32
  1215. MMRESULT ACMAPI acmFormatChooseA
  1216. (
  1217.     LPACMFORMATCHOOSEA      pafmtc
  1218. );
  1220. MMRESULT ACMAPI acmFormatChooseW
  1221. (
  1222.     LPACMFORMATCHOOSEW      pafmtc
  1223. );
  1225. #ifdef _UNICODE
  1226. #define acmFormatChoose     acmFormatChooseW
  1227. #else
  1228. #define acmFormatChoose     acmFormatChooseA
  1229. #endif
  1230. #else
  1231. MMRESULT ACMAPI acmFormatChoose
  1232. (
  1233.     LPACMFORMATCHOOSE       pafmtc
  1234. );
  1235. #endif
  1238. //--------------------------------------------------------------------------;
  1239. //
  1240. //  ACM Filter Tags
  1241. //
  1242. //
  1243. //
  1244. //
  1245. //--------------------------------------------------------------------------;
  1247. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1248. //
  1249. //  acmFilterTagDetails()
  1250. //
  1251. //
  1252. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1254. #define ACMFILTERTAGDETAILS_FILTERTAG_CHARS 48
  1256. #ifdef _WIN32
  1257. typedef struct tACMFILTERTAGDETAILSA
  1258. {
  1259.     DWORD           cbStruct;
  1260.     DWORD           dwFilterTagIndex;
  1261.     DWORD           dwFilterTag;
  1262.     DWORD           cbFilterSize;
  1263.     DWORD           fdwSupport;
  1264.     DWORD           cStandardFilters;
  1265.     char            szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS];
  1267. } ACMFILTERTAGDETAILSA, *PACMFILTERTAGDETAILSA, FAR *LPACMFILTERTAGDETAILSA;
  1269. typedef struct tACMFILTERTAGDETAILSW
  1270. {
  1271.     DWORD           cbStruct;
  1272.     DWORD           dwFilterTagIndex;
  1273.     DWORD           dwFilterTag;
  1274.     DWORD           cbFilterSize;
  1275.     DWORD           fdwSupport;
  1276.     DWORD           cStandardFilters;
  1277.     WCHAR           szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS];
  1279. } ACMFILTERTAGDETAILSW, *PACMFILTERTAGDETAILSW, FAR *LPACMFILTERTAGDETAILSW;
  1281. #ifdef _UNICODE
  1282. #define ACMFILTERTAGDETAILS     ACMFILTERTAGDETAILSW
  1283. #define PACMFILTERTAGDETAILS    PACMFILTERTAGDETAILSW
  1284. #define LPACMFILTERTAGDETAILS   LPACMFILTERTAGDETAILSW
  1285. #else
  1286. #define ACMFILTERTAGDETAILS     ACMFILTERTAGDETAILSA
  1287. #define PACMFILTERTAGDETAILS    PACMFILTERTAGDETAILSA
  1288. #define LPACMFILTERTAGDETAILS   LPACMFILTERTAGDETAILSA
  1289. #endif
  1290. #else
  1291. typedef struct tACMFILTERTAGDETAILS
  1292. {
  1293.     DWORD           cbStruct;
  1294.     DWORD           dwFilterTagIndex;
  1295.     DWORD           dwFilterTag;
  1296.     DWORD           cbFilterSize;
  1297.     DWORD           fdwSupport;
  1298.     DWORD           cStandardFilters;
  1299.     char            szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS];
  1301. } ACMFILTERTAGDETAILS, *PACMFILTERTAGDETAILS, FAR *LPACMFILTERTAGDETAILS;
  1302. #endif
  1304. #ifdef _WIN32
  1305. MMRESULT ACMAPI acmFilterTagDetailsA
  1306. (
  1307.     HACMDRIVER              had,
  1308.     LPACMFILTERTAGDETAILSA  paftd,
  1309.     DWORD                   fdwDetails
  1310. );
  1312. MMRESULT ACMAPI acmFilterTagDetailsW
  1313. (
  1314.     HACMDRIVER              had,
  1315.     LPACMFILTERTAGDETAILSW  paftd,
  1316.     DWORD                   fdwDetails
  1317. );
  1319. #ifdef _UNICODE
  1320. #define acmFilterTagDetails     acmFilterTagDetailsW
  1321. #else
  1322. #define acmFilterTagDetails     acmFilterTagDetailsA
  1323. #endif
  1324. #else
  1325. MMRESULT ACMAPI acmFilterTagDetails
  1326. (
  1327.     HACMDRIVER              had,
  1328.     LPACMFILTERTAGDETAILS   paftd,
  1329.     DWORD                   fdwDetails
  1330. );
  1331. #endif
  1333. #define ACM_FILTERTAGDETAILSF_INDEX         0x00000000L
  1334. #define ACM_FILTERTAGDETAILSF_FILTERTAG     0x00000001L
  1335. #define ACM_FILTERTAGDETAILSF_LARGESTSIZE   0x00000002L
  1336. #define ACM_FILTERTAGDETAILSF_QUERYMASK     0x0000000FL
  1339. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1340. //
  1341. //  acmFilterTagEnum()
  1342. //
  1343. //
  1344. //
  1345. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1347. #ifdef _WIN32
  1348. typedef BOOL (CALLBACK *ACMFILTERTAGENUMCBA)
  1349. (
  1350.     HACMDRIVERID            hadid,
  1351.     LPACMFILTERTAGDETAILSA  paftd,
  1352.     DWORD_PTR               dwInstance,
  1353.     DWORD                   fdwSupport
  1354. );
  1356. MMRESULT ACMAPI acmFilterTagEnumA
  1357. (
  1358.     HACMDRIVER              had,
  1359.     LPACMFILTERTAGDETAILSA  paftd,
  1360.     ACMFILTERTAGENUMCBA     fnCallback,
  1361.     DWORD_PTR               dwInstance,
  1362.     DWORD                   fdwEnum
  1363. );
  1365. typedef BOOL (CALLBACK *ACMFILTERTAGENUMCBW)
  1366. (
  1367.     HACMDRIVERID            hadid,
  1368.     LPACMFILTERTAGDETAILSW  paftd,
  1369.     DWORD_PTR               dwInstance,
  1370.     DWORD                   fdwSupport
  1371. );
  1373. MMRESULT ACMAPI acmFilterTagEnumW
  1374. (
  1375.     HACMDRIVER              had,
  1376.     LPACMFILTERTAGDETAILSW  paftd,
  1377.     ACMFILTERTAGENUMCBW     fnCallback,
  1378.     DWORD_PTR               dwInstance,
  1379.     DWORD                   fdwEnum
  1380. );
  1382. #ifdef _UNICODE
  1383. #define ACMFILTERTAGENUMCB  ACMFILTERTAGENUMCBW
  1384. #define acmFilterTagEnum    acmFilterTagEnumW
  1385. #else
  1386. #define ACMFILTERTAGENUMCB  ACMFILTERTAGENUMCBA
  1387. #define acmFilterTagEnum    acmFilterTagEnumA
  1388. #endif
  1389. #else
  1390. typedef BOOL (CALLBACK *ACMFILTERTAGENUMCB)
  1391. (
  1392.     HACMDRIVERID            hadid,
  1393.     LPACMFILTERTAGDETAILS   paftd,
  1394.     DWORD_PTR               dwInstance,
  1395.     DWORD                   fdwSupport
  1396. );
  1398. MMRESULT ACMAPI acmFilterTagEnum
  1399. (
  1400.     HACMDRIVER              had,
  1401.     LPACMFILTERTAGDETAILS   paftd,
  1402.     ACMFILTERTAGENUMCB      fnCallback,
  1403.     DWORD_PTR               dwInstance,
  1404.     DWORD                   fdwEnum
  1405. );
  1406. #endif
  1409. //--------------------------------------------------------------------------;
  1410. //
  1411. //  ACM Filters
  1412. //
  1413. //
  1414. //
  1415. //
  1416. //--------------------------------------------------------------------------;
  1418. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1419. //
  1420. //  acmFilterDetails()
  1421. //
  1422. //
  1423. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1425. #define ACMFILTERDETAILS_FILTER_CHARS   128
  1427. #ifdef _WIN32
  1428. typedef struct tACMFILTERDETAILSA
  1429. {
  1430.     DWORD           cbStruct;
  1431.     DWORD           dwFilterIndex;
  1432.     DWORD           dwFilterTag;
  1433.     DWORD           fdwSupport;
  1434.     LPWAVEFILTER    pwfltr;
  1435.     DWORD           cbwfltr;
  1436.     char            szFilter[ACMFILTERDETAILS_FILTER_CHARS];
  1438. } ACMFILTERDETAILSA, *PACMFILTERDETAILSA, FAR *LPACMFILTERDETAILSA;
  1440. typedef struct tACMFILTERDETAILSW
  1441. {
  1442.     DWORD           cbStruct;
  1443.     DWORD           dwFilterIndex;
  1444.     DWORD           dwFilterTag;
  1445.     DWORD           fdwSupport;
  1446.     LPWAVEFILTER    pwfltr;
  1447.     DWORD           cbwfltr;
  1448.     WCHAR           szFilter[ACMFILTERDETAILS_FILTER_CHARS];
  1450. } ACMFILTERDETAILSW, *PACMFILTERDETAILSW, FAR *LPACMFILTERDETAILSW;
  1452. #ifdef _UNICODE
  1453. #define ACMFILTERDETAILS    ACMFILTERDETAILSW
  1454. #define PACMFILTERDETAILS   PACMFILTERDETAILSW
  1455. #define LPACMFILTERDETAILS  LPACMFILTERDETAILSW
  1456. #else
  1457. #define ACMFILTERDETAILS    ACMFILTERDETAILSA
  1458. #define PACMFILTERDETAILS   PACMFILTERDETAILSA
  1459. #define LPACMFILTERDETAILS  LPACMFILTERDETAILSA
  1460. #endif
  1461. #else
  1462. typedef struct tACMFILTERDETAILS
  1463. {
  1464.     DWORD           cbStruct;
  1465.     DWORD           dwFilterIndex;
  1466.     DWORD           dwFilterTag;
  1467.     DWORD           fdwSupport;
  1468.     LPWAVEFILTER    pwfltr;
  1469.     DWORD           cbwfltr;
  1470.     char            szFilter[ACMFILTERDETAILS_FILTER_CHARS];
  1472. } ACMFILTERDETAILS, *PACMFILTERDETAILS, FAR *LPACMFILTERDETAILS;
  1473. #endif
  1475. #ifdef _WIN32
  1476. MMRESULT ACMAPI acmFilterDetailsA
  1477. (
  1478.     HACMDRIVER              had,
  1479.     LPACMFILTERDETAILSA     pafd,
  1480.     DWORD                   fdwDetails
  1481. );
  1483. MMRESULT ACMAPI acmFilterDetailsW
  1484. (
  1485.     HACMDRIVER              had,
  1486.     LPACMFILTERDETAILSW     pafd,
  1487.     DWORD                   fdwDetails
  1488. );
  1489. #ifdef _UNICODE
  1490. #define acmFilterDetails    acmFilterDetailsW
  1491. #else
  1492. #define acmFilterDetails    acmFilterDetailsA
  1493. #endif
  1494. #else
  1495. MMRESULT ACMAPI acmFilterDetails
  1496. (
  1497.     HACMDRIVER              had,
  1498.     LPACMFILTERDETAILS      pafd,
  1499.     DWORD                   fdwDetails
  1500. );
  1501. #endif
  1503. #define ACM_FILTERDETAILSF_INDEX        0x00000000L
  1504. #define ACM_FILTERDETAILSF_FILTER       0x00000001L
  1505. #define ACM_FILTERDETAILSF_QUERYMASK    0x0000000FL
  1508. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1509. //
  1510. //  acmFilterEnum()
  1511. //
  1512. //
  1513. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1515. #ifdef _WIN32
  1516. typedef BOOL (CALLBACK *ACMFILTERENUMCBA)
  1517. (
  1518.     HACMDRIVERID            hadid,
  1519.     LPACMFILTERDETAILSA     pafd,
  1520.     DWORD_PTR               dwInstance,
  1521.     DWORD                   fdwSupport
  1522. );
  1524. MMRESULT ACMAPI acmFilterEnumA
  1525. (
  1526.     HACMDRIVER              had,
  1527.     LPACMFILTERDETAILSA     pafd,
  1528.     ACMFILTERENUMCBA        fnCallback,
  1529.     DWORD_PTR               dwInstance,
  1530.     DWORD                   fdwEnum
  1531. );
  1533. typedef BOOL (CALLBACK *ACMFILTERENUMCBW)
  1534. (
  1535.     HACMDRIVERID            hadid,
  1536.     LPACMFILTERDETAILSW     pafd,
  1537.     DWORD_PTR               dwInstance,
  1538.     DWORD                   fdwSupport
  1539. );
  1541. MMRESULT ACMAPI acmFilterEnumW
  1542. (
  1543.     HACMDRIVER              had,
  1544.     LPACMFILTERDETAILSW     pafd,
  1545.     ACMFILTERENUMCBW        fnCallback,
  1546.     DWORD_PTR               dwInstance,
  1547.     DWORD                   fdwEnum
  1548. );
  1550. #ifdef _UNICODE
  1551. #define ACMFILTERENUMCB     ACMFILTERENUMCBW
  1552. #define acmFilterEnum       acmFilterEnumW
  1553. #else
  1554. #define ACMFILTERENUMCB     ACMFILTERENUMCBA
  1555. #define acmFilterEnum       acmFilterEnumA
  1556. #endif
  1557. #else
  1558. typedef BOOL (CALLBACK *ACMFILTERENUMCB)
  1559. (
  1560.     HACMDRIVERID            hadid,
  1561.     LPACMFILTERDETAILS      pafd,
  1562.     DWORD_PTR               dwInstance,
  1563.     DWORD                   fdwSupport
  1564. );
  1566. MMRESULT ACMAPI acmFilterEnum
  1567. (
  1568.     HACMDRIVER              had,
  1569.     LPACMFILTERDETAILS      pafd,
  1570.     ACMFILTERENUMCB         fnCallback,
  1571.     DWORD_PTR               dwInstance,
  1572.     DWORD                   fdwEnum
  1573. );
  1574. #endif
  1576. #define ACM_FILTERENUMF_DWFILTERTAG         0x00010000L
  1580. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1581. //
  1582. //  acmFilterChoose()
  1583. //
  1584. //
  1585. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1587. //
  1588. //  MM_ACM_FILTERCHOOSE is sent to hook callbacks by the Filter Chooser
  1589. //  Dialog...
  1590. //
  1591. #define MM_ACM_FILTERCHOOSE             (0x8000)
  1593. #define FILTERCHOOSE_MESSAGE            0
  1594. #define FILTERCHOOSE_FILTERTAG_VERIFY   (FILTERCHOOSE_MESSAGE+0)
  1595. #define FILTERCHOOSE_FILTER_VERIFY      (FILTERCHOOSE_MESSAGE+1)
  1596. #define FILTERCHOOSE_CUSTOM_VERIFY      (FILTERCHOOSE_MESSAGE+2)
  1598. #ifdef _WIN32
  1599. typedef UINT (CALLBACK *ACMFILTERCHOOSEHOOKPROCA)
  1600. (
  1601.     HWND                    hwnd,
  1602.     UINT                    uMsg,
  1603.     WPARAM                  wParam,
  1604.     LPARAM                  lParam
  1605. );
  1607. typedef UINT (CALLBACK *ACMFILTERCHOOSEHOOKPROCW)
  1608. (
  1609.     HWND                    hwnd,
  1610.     UINT                    uMsg,
  1611.     WPARAM                  wParam,
  1612.     LPARAM                  lParam
  1613. );
  1615. #ifdef _UNICODE
  1616. #define ACMFILTERCHOOSEHOOKPROC     ACMFILTERCHOOSEHOOKPROCW
  1617. #else
  1618. #define ACMFILTERCHOOSEHOOKPROC     ACMFILTERCHOOSEHOOKPROCA
  1619. #endif
  1620. #else
  1621. typedef UINT (CALLBACK *ACMFILTERCHOOSEHOOKPROC)
  1622. (
  1623.     HWND                    hwnd,
  1624.     UINT                    uMsg,
  1625.     WPARAM                  wParam,
  1626.     LPARAM                  lParam
  1627. );
  1628. #endif
  1630. //
  1631. //  ACMFILTERCHOOSE
  1632. //
  1633. //
  1634. #ifdef _WIN32
  1635. typedef struct tACMFILTERCHOOSEA
  1636. {
  1637.     DWORD           cbStruct;           // sizeof(ACMFILTERCHOOSE)
  1638.     DWORD           fdwStyle;           // chooser style flags
  1640.     HWND            hwndOwner;          // caller's window handle
  1642.     LPWAVEFILTER    pwfltr;             // ptr to wfltr buf to receive choice
  1643.     DWORD           cbwfltr;            // size of mem buf for pwfltr
  1645.     LPCSTR          pszTitle;
  1647.     char            szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS];
  1648.     char            szFilter[ACMFILTERDETAILS_FILTER_CHARS];
  1649.     LPSTR           pszName;            // custom name selection
  1650.     DWORD           cchName;            // size in chars of mem buf for pszName
  1652.     DWORD           fdwEnum;            // filter enumeration restrictions
  1653.     LPWAVEFILTER    pwfltrEnum;         // filter describing restrictions
  1655.     HINSTANCE       hInstance;          // app instance containing dlg template
  1656.     LPCSTR          pszTemplateName;    // custom template name
  1657.     LPARAM          lCustData;          // data passed to hook fn.
  1658.     ACMFILTERCHOOSEHOOKPROCA pfnHook;    // ptr to hook function
  1660. } ACMFILTERCHOOSEA, *PACMFILTERCHOOSEA, FAR *LPACMFILTERCHOOSEA;
  1662. typedef struct tACMFILTERCHOOSEW
  1663. {
  1664.     DWORD           cbStruct;           // sizeof(ACMFILTERCHOOSE)
  1665.     DWORD           fdwStyle;           // chooser style flags
  1667.     HWND            hwndOwner;          // caller's window handle
  1669.     LPWAVEFILTER    pwfltr;             // ptr to wfltr buf to receive choice
  1670.     DWORD           cbwfltr;            // size of mem buf for pwfltr
  1672.     LPCWSTR         pszTitle;
  1674.     WCHAR           szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS];
  1675.     WCHAR           szFilter[ACMFILTERDETAILS_FILTER_CHARS];
  1676.     LPWSTR          pszName;            // custom name selection
  1677.     DWORD           cchName;            // size in chars of mem buf for pszName
  1679.     DWORD           fdwEnum;            // filter enumeration restrictions
  1680.     LPWAVEFILTER    pwfltrEnum;         // filter describing restrictions
  1682.     HINSTANCE       hInstance;          // app instance containing dlg template
  1683.     LPCWSTR         pszTemplateName;    // custom template name
  1684.     LPARAM          lCustData;          // data passed to hook fn.
  1685.     ACMFILTERCHOOSEHOOKPROCW pfnHook;    // ptr to hook function
  1687. } ACMFILTERCHOOSEW, *PACMFILTERCHOOSEW, FAR *LPACMFILTERCHOOSEW;
  1689. #ifdef _UNICODE
  1690. #define ACMFILTERCHOOSE     ACMFILTERCHOOSEW
  1691. #define PACMFILTERCHOOSE    PACMFILTERCHOOSEW
  1692. #define LPACMFILTERCHOOSE   LPACMFILTERCHOOSEW
  1693. #else
  1694. #define ACMFILTERCHOOSE     ACMFILTERCHOOSEA
  1695. #define PACMFILTERCHOOSE    PACMFILTERCHOOSEA
  1696. #define LPACMFILTERCHOOSE   LPACMFILTERCHOOSEA
  1697. #endif
  1698. #else
  1699. typedef struct tACMFILTERCHOOSE
  1700. {
  1701.     DWORD           cbStruct;           // sizeof(ACMFILTERCHOOSE)
  1702.     DWORD           fdwStyle;           // chooser style flags
  1704.     HWND            hwndOwner;          // caller's window handle
  1706.     LPWAVEFILTER    pwfltr;             // ptr to wfltr buf to receive choice
  1707.     DWORD           cbwfltr;            // size of mem buf for pwfltr
  1709.     LPCSTR          pszTitle;
  1711.     char            szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS];
  1712.     char            szFilter[ACMFILTERDETAILS_FILTER_CHARS];
  1713.     LPSTR           pszName;            // custom name selection
  1714.     DWORD           cchName;            // size in chars of mem buf for pszName
  1716.     DWORD           fdwEnum;            // filter enumeration restrictions
  1717.     LPWAVEFILTER    pwfltrEnum;         // filter describing restrictions
  1719.     HINSTANCE       hInstance;          // app instance containing dlg template
  1720.     LPCSTR          pszTemplateName;    // custom template name
  1721.     LPARAM          lCustData;          // data passed to hook fn.
  1722.     ACMFILTERCHOOSEHOOKPROC pfnHook;    // ptr to hook function
  1724. } ACMFILTERCHOOSE, *PACMFILTERCHOOSE, FAR *LPACMFILTERCHOOSE;
  1725. #endif
  1727. //
  1728. //  ACMFILTERCHOOSE.fdwStyle
  1729. //
  1730. //
  1731. #define ACMFILTERCHOOSE_STYLEF_SHOWHELP              0x00000004L
  1732. #define ACMFILTERCHOOSE_STYLEF_ENABLEHOOK            0x00000008L
  1733. #define ACMFILTERCHOOSE_STYLEF_ENABLETEMPLATE        0x00000010L
  1734. #define ACMFILTERCHOOSE_STYLEF_ENABLETEMPLATEHANDLE  0x00000020L
  1735. #define ACMFILTERCHOOSE_STYLEF_INITTOFILTERSTRUCT    0x00000040L
  1736. #define ACMFILTERCHOOSE_STYLEF_CONTEXTHELP           0x00000080L
  1738. #ifdef _WIN32
  1739. MMRESULT ACMAPI acmFilterChooseA
  1740. (
  1741.     LPACMFILTERCHOOSEA      pafltrc
  1742. );
  1744. MMRESULT ACMAPI acmFilterChooseW
  1745. (
  1746.     LPACMFILTERCHOOSEW      pafltrc
  1747. );
  1749. #ifdef _UNICODE
  1750. #define acmFilterChoose     acmFilterChooseW
  1751. #else
  1752. #define acmFilterChoose     acmFilterChooseA
  1753. #endif
  1754. #else
  1755. MMRESULT ACMAPI acmFilterChoose
  1756. (
  1757.     LPACMFILTERCHOOSE       pafltrc
  1758. );
  1759. #endif
  1762. //--------------------------------------------------------------------------;
  1763. //
  1764. //  ACM Stream API's
  1765. //
  1766. //
  1767. //
  1768. //--------------------------------------------------------------------------;
  1770. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1771. //
  1772. //  acmStreamOpen()
  1773. //
  1774. //
  1775. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1776. #ifdef  _WIN64
  1777. #define _DRVRESERVED    15
  1778. #else
  1779. #define _DRVRESERVED    10
  1780. #endif  // _WIN64
  1782. typedef struct tACMSTREAMHEADER
  1783. {
  1784.     DWORD           cbStruct;               // sizeof(ACMSTREAMHEADER)
  1785.     DWORD           fdwStatus;              // ACMSTREAMHEADER_STATUSF_*
  1786.     DWORD_PTR       dwUser;                 // user instance data for hdr
  1787.     LPBYTE          pbSrc;
  1788.     DWORD           cbSrcLength;
  1789.     DWORD           cbSrcLengthUsed;
  1790.     DWORD_PTR       dwSrcUser;              // user instance data for src
  1791.     LPBYTE          pbDst;
  1792.     DWORD           cbDstLength;
  1793.     DWORD           cbDstLengthUsed;
  1794.     DWORD_PTR       dwDstUser;              // user instance data for dst
  1795.     DWORD           dwReservedDriver[_DRVRESERVED];   // driver reserved work space
  1797. } ACMSTREAMHEADER, *PACMSTREAMHEADER, FAR *LPACMSTREAMHEADER;
  1799. //
  1800. //  ACMSTREAMHEADER.fdwStatus
  1801. //
  1802. //  ACMSTREAMHEADER_STATUSF_DONE: done bit for async conversions.
  1803. //
  1804. #define ACMSTREAMHEADER_STATUSF_DONE        0x00010000L
  1805. #define ACMSTREAMHEADER_STATUSF_PREPARED    0x00020000L
  1806. #define ACMSTREAMHEADER_STATUSF_INQUEUE     0x00100000L
  1809. MMRESULT ACMAPI acmStreamOpen
  1810. (
  1811.     LPHACMSTREAM            phas,       // pointer to stream handle
  1812.     HACMDRIVER              had,        // optional driver handle
  1813.     LPWAVEFORMATEX          pwfxSrc,    // source format to convert
  1814.     LPWAVEFORMATEX          pwfxDst,    // required destination format
  1815.     LPWAVEFILTER            pwfltr,     // optional filter
  1816.     DWORD_PTR               dwCallback, // callback
  1817.     DWORD_PTR               dwInstance, // callback instance data
  1818.     DWORD                   fdwOpen     // ACM_STREAMOPENF_* and CALLBACK_*
  1819. );
  1821. #define ACM_STREAMOPENF_QUERY           0x00000001
  1822. #define ACM_STREAMOPENF_ASYNC           0x00000002
  1823. #define ACM_STREAMOPENF_NONREALTIME     0x00000004
  1826. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1827. //
  1828. //  acmStreamClose()
  1829. //
  1830. //
  1831. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1833. MMRESULT ACMAPI acmStreamClose
  1834. (
  1835.     HACMSTREAM              has,
  1836.     DWORD                   fdwClose
  1837. );
  1840. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1841. //
  1842. //  acmStreamSize()
  1843. //
  1844. //
  1845. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1847. MMRESULT ACMAPI acmStreamSize
  1848. (
  1849.     HACMSTREAM              has,
  1850.     DWORD                   cbInput,
  1851.     LPDWORD                 pdwOutputBytes,
  1852.     DWORD                   fdwSize
  1853. );
  1855. #define ACM_STREAMSIZEF_SOURCE          0x00000000L
  1856. #define ACM_STREAMSIZEF_DESTINATION     0x00000001L
  1857. #define ACM_STREAMSIZEF_QUERYMASK       0x0000000FL
  1860. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1861. //
  1862. //  acmStreamReset()
  1863. //
  1864. //
  1865. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1867. MMRESULT ACMAPI acmStreamReset
  1868. (
  1869.     HACMSTREAM              has,
  1870.     DWORD                   fdwReset
  1871. );
  1876. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1877. //
  1878. //  acmStreamMessage()
  1879. //
  1880. //
  1881. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1883. MMRESULT ACMAPI acmStreamMessage
  1884. (
  1885.     HACMSTREAM              has,
  1886.     UINT                    uMsg,
  1887.     LPARAM                  lParam1,
  1888.     LPARAM                  lParam2
  1889. );
  1893. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1894. //
  1895. //  acmStreamConvert()
  1896. //
  1897. //
  1898. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1900. MMRESULT ACMAPI acmStreamConvert
  1901. (
  1902.     HACMSTREAM              has,
  1903.     LPACMSTREAMHEADER       pash,
  1904.     DWORD                   fdwConvert
  1905. );
  1907. #define ACM_STREAMCONVERTF_BLOCKALIGN   0x00000004
  1908. #define ACM_STREAMCONVERTF_START        0x00000010
  1909. #define ACM_STREAMCONVERTF_END          0x00000020
  1912. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1913. //
  1914. //  acmStreamPrepareHeader()
  1915. //
  1916. //
  1917. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1919. MMRESULT ACMAPI acmStreamPrepareHeader
  1920. (
  1921.     HACMSTREAM          has,
  1922.     LPACMSTREAMHEADER   pash,
  1923.     DWORD               fdwPrepare
  1924. );
  1928. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1929. //
  1930. //  acmStreamUnprepareHeader()
  1931. //
  1932. //
  1933. //- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ;
  1935. MMRESULT ACMAPI acmStreamUnprepareHeader
  1936. (
  1937.     HACMSTREAM          has,
  1938.     LPACMSTREAMHEADER   pash,
  1939.     DWORD               fdwUnprepare
  1940. );
  1943. #include "poppack.h"    /* Revert to default packing */
  1945. #ifdef __cplusplus
  1946. }                       /* End of extern "C" { */
  1947. #endif  /* __cplusplus */
  1949. #endif  /* _INC_ACM */