home *** CD-ROM | disk | FTP | other *** search
/ Beginning Direct3D Game Programming / Direct3D.iso / directx / dxf / include / dvoice.h < prev    next >
C/C++ Source or Header  |  2000-10-20  |  35KB  |  851 lines
  1. /*==========================================================================;
  2.  *
  3.  *  Copyright (C) 1999 Microsoft Corporation.  All Rights Reserved.
  4.  *
  5.  *  File:       dpvoice.h
  6.  *  Content:    DirectPlayVoice include file
  7.  ***************************************************************************/
  8.  
  9. #ifndef __DVOICE__
  10. #define __DVOICE__
  11.  
  12. #include <ole2.h>            // for DECLARE_INTERFACE and HRESULT
  13. #include <mmsystem.h>
  14. #include <mmreg.h>
  15. #include <msacm.h>
  16. #include "dsound.h"
  17.  
  18. #ifdef __cplusplus
  19. extern "C" {
  20. #endif
  21.  
  22. /****************************************************************************
  23.  *
  24.  * DirectPlayVoice CLSIDs
  25.  *
  26.  ****************************************************************************/
  27.  
  28.  
  29. // {B9F3EB85-B781-4ac1-8D90-93A05EE37D7D}
  30. DEFINE_GUID(CLSID_DirectPlayVoiceClient, 
  31. 0xb9f3eb85, 0xb781, 0x4ac1, 0x8d, 0x90, 0x93, 0xa0, 0x5e, 0xe3, 0x7d, 0x7d);
  32.  
  33. // {D3F5B8E6-9B78-4a4c-94EA-CA2397B663D3}
  34. DEFINE_GUID(CLSID_DirectPlayVoiceServer, 
  35. 0xd3f5b8e6, 0x9b78, 0x4a4c, 0x94, 0xea, 0xca, 0x23, 0x97, 0xb6, 0x63, 0xd3);
  36.  
  37. // {0F0F094B-B01C-4091-A14D-DD0CD807711A}
  38. DEFINE_GUID(CLSID_DirectPlayVoiceTest, 
  39. 0xf0f094b, 0xb01c, 0x4091, 0xa1, 0x4d, 0xdd, 0xc, 0xd8, 0x7, 0x71, 0x1a);
  40.  
  41. /****************************************************************************
  42.  *
  43.  * DirectPlayVoice Interface IIDs
  44.  *
  45.  ****************************************************************************/
  46.  
  47.  
  48. // {1DFDC8EA-BCF7-41d6-B295-AB64B3B23306}
  49. DEFINE_GUID(IID_IDirectPlayVoiceClient, 
  50. 0x1dfdc8ea, 0xbcf7, 0x41d6, 0xb2, 0x95, 0xab, 0x64, 0xb3, 0xb2, 0x33, 0x6);
  51.  
  52. // {FAA1C173-0468-43b6-8A2A-EA8A4F2076C9}
  53. DEFINE_GUID(IID_IDirectPlayVoiceServer, 
  54. 0xfaa1c173, 0x468, 0x43b6, 0x8a, 0x2a, 0xea, 0x8a, 0x4f, 0x20, 0x76, 0xc9);
  55.  
  56. // {D26AF734-208B-41da-8224-E0CE79810BE1}
  57. DEFINE_GUID(IID_IDirectPlayVoiceTest,
  58. 0xd26af734, 0x208b, 0x41da, 0x82, 0x24, 0xe0, 0xce, 0x79, 0x81, 0xb, 0xe1);
  59.  
  60. /****************************************************************************
  61.  *
  62.  * DirectPlayVoice Compression Type GUIDs
  63.  *
  64.  ****************************************************************************/
  65.  
  66. // MS-ADPCM 32.8 kbit/s
  67. //
  68. // {699B52C1-A885-46a8-A308-97172419ADC7}
  69. DEFINE_GUID(DPVCTGUID_ADPCM,
  70. 0x699b52c1, 0xa885, 0x46a8, 0xa3, 0x8, 0x97, 0x17, 0x24, 0x19, 0xad, 0xc7);
  71.  
  72. // Microsoft GSM 6.10 13 kbit/s
  73. //
  74. // {24768C60-5A0D-11d3-9BE4-525400D985E7}
  75. DEFINE_GUID(DPVCTGUID_GSM,
  76. 0x24768c60, 0x5a0d, 0x11d3, 0x9b, 0xe4, 0x52, 0x54, 0x0, 0xd9, 0x85, 0xe7);
  77.  
  78. // MS-PCM 64 kbit/s
  79. // 
  80. // {8DE12FD4-7CB3-48ce-A7E8-9C47A22E8AC5}
  81. DEFINE_GUID(DPVCTGUID_NONE,
  82. 0x8de12fd4, 0x7cb3, 0x48ce, 0xa7, 0xe8, 0x9c, 0x47, 0xa2, 0x2e, 0x8a, 0xc5);
  83.  
  84. // Voxware SC03 3.2kbit/s
  85. //
  86. // {7D82A29B-2242-4f82-8F39-5D1153DF3E41}
  87. DEFINE_GUID(DPVCTGUID_SC03,
  88. 0x7d82a29b, 0x2242, 0x4f82, 0x8f, 0x39, 0x5d, 0x11, 0x53, 0xdf, 0x3e, 0x41);
  89.  
  90. // Voxware SC06 6.4kbit/s
  91. //
  92. // {53DEF900-7168-4633-B47F-D143916A13C7}
  93. DEFINE_GUID(DPVCTGUID_SC06,
  94. 0x53def900, 0x7168, 0x4633, 0xb4, 0x7f, 0xd1, 0x43, 0x91, 0x6a, 0x13, 0xc7);
  95.  
  96. // TrueSpeech(TM) 8.6 kbit/s
  97. //
  98. // {D7954361-5A0B-11d3-9BE4-525400D985E7}
  99. DEFINE_GUID(DPVCTGUID_TRUESPEECH,
  100. 0xd7954361, 0x5a0b, 0x11d3, 0x9b, 0xe4, 0x52, 0x54, 0x0, 0xd9, 0x85, 0xe7);
  101.  
  102. // Voxware VR12 1.4kbit/s
  103. //
  104. // {FE44A9FE-8ED4-48bf-9D66-1B1ADFF9FF6D}
  105. DEFINE_GUID(DPVCTGUID_VR12,
  106. 0xfe44a9fe, 0x8ed4, 0x48bf, 0x9d, 0x66, 0x1b, 0x1a, 0xdf, 0xf9, 0xff, 0x6d);
  107.  
  108. // Define the default compression type
  109. #define DPVCTGUID_DEFAULT    DPVCTGUID_SC03
  110.  
  111. /****************************************************************************
  112.  *
  113.  * DirectPlayVoice Interface Pointer definitions
  114.  *
  115.  ****************************************************************************/
  116.  
  117. typedef struct IDirectPlayVoiceClient FAR *LPDIRECTPLAYVOICECLIENT, *PDIRECTPLAYVOICECLIENT;
  118. typedef struct IDirectPlayVoiceServer FAR *LPDIRECTPLAYVOICESERVER, *PDIRECTPLAYVOICESERVER;
  119. typedef struct IDirectPlayVoiceTest FAR *LPDIRECTPLAYVOICETEST, *PDIRECTPLAYVOICETEST;
  120.  
  121. /****************************************************************************
  122.  *
  123.  * DirectPlayVoice Callback Functions
  124.  *
  125.  ****************************************************************************/
  126. typedef HRESULT (FAR PASCAL *PDVMESSAGEHANDLER)(
  127.     PVOID   pvUserContext,
  128.     DWORD   dwMessageType,
  129.     LPVOID  lpMessage
  130. );
  131.  
  132. typedef PDVMESSAGEHANDLER LPDVMESSAGEHANDLER;
  133.  
  134. /****************************************************************************
  135.  *
  136.  * DirectPlayVoice Datatypes (Non-Structure / Non-Message)
  137.  *
  138.  ****************************************************************************/
  139.  
  140. typedef DWORD DVID, *LPDVID, *PDVID;
  141.  
  142. /****************************************************************************
  143.  *
  144.  * DirectPlayVoice Message Types
  145.  *
  146.  ****************************************************************************/
  147.  
  148. #define DVMSGID_BASE                        0x0000
  149.  
  150. #define DVMSGID_MINBASE                     (DVMSGID_CREATEVOICEPLAYER)
  151. #define DVMSGID_CREATEVOICEPLAYER           (DVMSGID_BASE+0x0001)
  152. #define DVMSGID_DELETEVOICEPLAYER           (DVMSGID_BASE+0x0002)
  153. #define DVMSGID_SESSIONLOST                 (DVMSGID_BASE+0x0003)
  154. #define DVMSGID_PLAYERVOICESTART            (DVMSGID_BASE+0x0004)
  155. #define DVMSGID_PLAYERVOICESTOP             (DVMSGID_BASE+0x0005)
  156. #define DVMSGID_RECORDSTART                 (DVMSGID_BASE+0x0006)
  157. #define DVMSGID_RECORDSTOP                  (DVMSGID_BASE+0x0007)
  158. #define DVMSGID_CONNECTRESULT               (DVMSGID_BASE+0x0008)
  159. #define DVMSGID_DISCONNECTRESULT            (DVMSGID_BASE+0x0009)
  160. #define DVMSGID_INPUTLEVEL                  (DVMSGID_BASE+0x000A)
  161. #define DVMSGID_OUTPUTLEVEL                 (DVMSGID_BASE+0x000B)
  162. #define DVMSGID_HOSTMIGRATED                (DVMSGID_BASE+0x000C)
  163. #define DVMSGID_SETTARGETS                  (DVMSGID_BASE+0x000D)
  164. #define DVMSGID_PLAYEROUTPUTLEVEL           (DVMSGID_BASE+0x000E)
  165. #define DVMSGID_LOSTFOCUS                   (DVMSGID_BASE+0x0010)
  166. #define DVMSGID_GAINFOCUS                   (DVMSGID_BASE+0x0011)
  167. #define DVMSGID_LOCALHOSTSETUP                (DVMSGID_BASE+0x0012)
  168. #define DVMSGID_MAXBASE                     (DVMSGID_LOCALHOSTSETUP)
  169.  
  170. /****************************************************************************
  171.  *
  172.  * DirectPlayVoice Constants
  173.  *
  174.  ****************************************************************************/
  175.  
  176. //
  177. // Buffer Aggresiveness Value Ranges
  178. //
  179. #define DVBUFFERAGGRESSIVENESS_MIN          0x00000001
  180. #define DVBUFFERAGGRESSIVENESS_MAX          0x00000064
  181. #define DVBUFFERAGGRESSIVENESS_DEFAULT      0x00000000
  182.  
  183. // 
  184. // Buffer Quality Value Ranges
  185. //
  186. #define DVBUFFERQUALITY_MIN                 0x00000001
  187. #define DVBUFFERQUALITY_MAX                 0x00000064
  188. #define DVBUFFERQUALITY_DEFAULT             0x00000000
  189.  
  190. #define DVID_SYS                0
  191.  
  192. //
  193. // Used to identify the session host in client/server
  194. //
  195. #define DVID_SERVERPLAYER       1
  196.  
  197. //
  198. // Used to target all players
  199. //
  200. #define DVID_ALLPLAYERS         0
  201.  
  202. //
  203. // Used to identify the main buffer
  204. //
  205. #define DVID_REMAINING          0xFFFFFFFF
  206.  
  207. // 
  208. // Input level range
  209. //
  210. #define DVINPUTLEVEL_MIN                    0x00000000
  211. #define DVINPUTLEVEL_MAX                    0x00000063    // 99 decimal
  212.  
  213. #define DVNOTIFYPERIOD_MINPERIOD            20
  214.  
  215.  
  216. #define DVPLAYBACKVOLUME_DEFAULT            DSBVOLUME_MAX
  217.  
  218. #define DVRECORDVOLUME_LAST                 0x00000001
  219.  
  220.  
  221. //
  222. // Use the default value
  223. //
  224. #define DVTHRESHOLD_DEFAULT               0xFFFFFFFF
  225.  
  226. //
  227. // Threshold Ranges
  228. //
  229. #define DVTHRESHOLD_MIN                   0x00000000
  230. #define DVTHRESHOLD_MAX                   0x00000063    // 99 decimal
  231.  
  232. //
  233. // Threshold field is not used 
  234. //
  235. #define DVTHRESHOLD_UNUSED                0xFFFFFFFE
  236.  
  237. //
  238. // Session Types
  239. //
  240. #define DVSESSIONTYPE_PEER                  0x00000001
  241. #define DVSESSIONTYPE_MIXING                0x00000002
  242. #define DVSESSIONTYPE_FORWARDING            0x00000003
  243. #define DVSESSIONTYPE_ECHO                  0x00000004
  244.  
  245. /****************************************************************************
  246.  *
  247.  * DirectPlayVoice Flags
  248.  *
  249.  ****************************************************************************/
  250.  
  251.  
  252. // 
  253. // Enable automatic adjustment of the recording volume
  254. //
  255. #define DVCLIENTCONFIG_AUTORECORDVOLUME     0x00000008
  256.  
  257. //
  258. // Enable automatic voice activation
  259. //
  260. #define DVCLIENTCONFIG_AUTOVOICEACTIVATED   0x00000020
  261.  
  262. // 
  263. // Enable echo suppression
  264. //
  265. #define DVCLIENTCONFIG_ECHOSUPPRESSION      0x08000000
  266.  
  267. // 
  268. // Voice Activation manual mode
  269. //
  270. #define DVCLIENTCONFIG_MANUALVOICEACTIVATED 0x00000004
  271.  
  272. // 
  273. // Only playback voices that have buffers created for them
  274. //
  275. #define DVCLIENTCONFIG_MUTEGLOBAL           0x00000010
  276.  
  277. // 
  278. // Mute the playback
  279. //
  280. #define DVCLIENTCONFIG_PLAYBACKMUTE         0x00000002
  281.  
  282. //
  283. // Mute the recording 
  284. //
  285. #define DVCLIENTCONFIG_RECORDMUTE           0x00000001
  286.  
  287. // 
  288. // Complete the operation before returning
  289. //
  290. #define DVFLAGS_SYNC                        0x00000001
  291.  
  292. // 
  293. // Just check to see if wizard has been run, and if so what it's results were
  294. //
  295. #define DVFLAGS_QUERYONLY                   0x00000002
  296.  
  297. //
  298. // Shutdown the voice session without migrating the host
  299. //
  300. #define DVFLAGS_NOHOSTMIGRATE               0x00000008
  301.  
  302. // 
  303. // Allow the back button to be enabled in the wizard
  304. //
  305. #define DVFLAGS_ALLOWBACK                   0x00000010
  306.  
  307. //
  308. // Disable host migration in the voice session
  309. //
  310. #define DVSESSION_NOHOSTMIGRATION           0x00000001
  311.  
  312. // 
  313. // Server controlled targetting
  314. //
  315. #define DVSESSION_SERVERCONTROLTARGET       0x00000002
  316.  
  317. //
  318. // Use DirectSound Normal Mode instead of priority 
  319. //
  320. #define DVSOUNDCONFIG_NORMALMODE            0x00000001
  321.  
  322. //
  323. // Automatically select the microphone
  324. //
  325. #define DVSOUNDCONFIG_AUTOSELECT            0x00000002
  326.  
  327. // 
  328. // Run in half duplex mode
  329. //
  330. #define DVSOUNDCONFIG_HALFDUPLEX            0x00000004
  331.  
  332. // 
  333. // No volume controls are available for the recording device
  334. //
  335. #define DVSOUNDCONFIG_NORECVOLAVAILABLE     0x00000010
  336.  
  337. // 
  338. // Disable capture sharing
  339. //
  340. #define DVSOUNDCONFIG_NOFOCUS               0x20000000
  341.  
  342. // 
  343. // Set system conversion quality to high
  344. //
  345. #define DVSOUNDCONFIG_SETCONVERSIONQUALITY    0x00000008
  346.  
  347. //
  348. // Enable strict focus mode
  349. // 
  350. #define DVSOUNDCONFIG_STRICTFOCUS           0x40000000
  351.  
  352. //
  353. // Player is in half duplex mode
  354. //
  355. #define DVPLAYERCAPS_HALFDUPLEX             0x00000001
  356.  
  357. // 
  358. // Specifies that player is the local player
  359. //
  360. #define DVPLAYERCAPS_LOCAL                  0x00000002
  361.  
  362.  
  363. /****************************************************************************
  364.  *
  365.  * DirectPlayVoice Structures (Non-Message)
  366.  *
  367.  ****************************************************************************/
  368.  
  369.  
  370. //
  371. // DirectPlayVoice Caps
  372. // (GetCaps / SetCaps)
  373. //
  374. typedef struct
  375. {
  376.     DWORD   dwSize;                 // Size of this structure
  377.     DWORD   dwFlags;                // Caps flags
  378. } DVCAPS, *LPDVCAPS, *PDVCAPS;
  379.  
  380. //
  381. // DirectPlayVoice Client Configuration
  382. // (Connect / GetClientConfig)
  383. //
  384. typedef struct
  385. {
  386.     DWORD   dwSize;                 // Size of this structure
  387.     DWORD   dwFlags;                // Flags for client config (DVCLIENTCONFIG_...)
  388.     LONG    lRecordVolume;          // Recording volume 
  389.     LONG    lPlaybackVolume;        // Playback volume
  390.     DWORD   dwThreshold;          // Voice Activation Threshold
  391.     DWORD   dwBufferQuality;        // Buffer quality
  392.     DWORD   dwBufferAggressiveness; // Buffer aggressiveness
  393.     DWORD   dwNotifyPeriod;         // Period of notification messages (ms)
  394. } DVCLIENTCONFIG, *LPDVCLIENTCONFIG, *PDVCLIENTCONFIG;
  395.  
  396. //
  397. // DirectPlayVoice Compression Type Information
  398. // (GetCompressionTypes)
  399. //
  400. typedef struct
  401. {
  402.     DWORD   dwSize;                 // Size of this structure
  403.     GUID    guidType;               // GUID that identifies this compression type
  404.     LPWSTR  lpszName;               // String name of this compression type
  405.     LPWSTR  lpszDescription;        // Description for this compression type
  406.     DWORD   dwFlags;                // Flags for this compression type
  407.     DWORD   dwMaxBitsPerSecond;        // Maximum # of bit/s this compression type uses
  408. } DVCOMPRESSIONINFO, *LPDVCOMPRESSIONINFO, *PDVCOMPRESSIONINFO;
  409.  
  410. //
  411. // DirectPlayVoice Session Description
  412. // (Host / GetSessionDesc)
  413. //
  414. typedef struct
  415. {
  416.     DWORD   dwSize;                 // Size of this structure
  417.     DWORD   dwFlags;                // Session flags (DVSESSION_...)
  418.     DWORD   dwSessionType;          // Session type (DVSESSIONTYPE_...)
  419.     GUID    guidCT;                 // Compression Type to use
  420.     DWORD   dwBufferQuality;        // Buffer quality
  421.     DWORD   dwBufferAggressiveness; // Buffer aggresiveness
  422. } DVSESSIONDESC, *LPDVSESSIONDESC, *PDVSESSIONDESC;
  423.  
  424. // 
  425. // DirectPlayVoice Client Sound Device Configuration
  426. // (Connect / GetSoundDeviceConfig)
  427. //
  428. typedef struct
  429. {
  430.     DWORD                   dwSize;                 // Size of this structure
  431.     DWORD                   dwFlags;                // Flags for sound config (DVSOUNDCONFIG_...)
  432.     GUID                    guidPlaybackDevice;     // GUID of the playback device to use
  433.     LPDIRECTSOUND           lpdsPlaybackDevice;     // DirectSound Object to use (optional)
  434.     GUID                    guidCaptureDevice;      // GUID of the capture device to use
  435.     LPDIRECTSOUNDCAPTURE    lpdsCaptureDevice;      // DirectSoundCapture Object to use (optional)
  436.     HWND                    hwndAppWindow;          // HWND of your application's top-level window
  437.     LPDIRECTSOUNDBUFFER     lpdsMainBuffer;         // DirectSoundBuffer to use for playback (optional)
  438.     DWORD                   dwMainBufferFlags;      // Flags to pass to Play() on the main buffer
  439.     DWORD                   dwMainBufferPriority;   // Priority to set when calling Play() on the main buffer
  440. } DVSOUNDDEVICECONFIG, *LPDVSOUNDDEVICECONFIG, *PDVSOUNDDEVICECONFIG;
  441.  
  442. /****************************************************************************
  443.  *
  444.  * DirectPlayVoice message handler call back structures
  445.  *
  446.  ****************************************************************************/
  447.  
  448. //
  449. // Result of the Connect() call.  (If it wasn't called Async)
  450. // (DVMSGID_CONNECTRESULT)
  451. //
  452. typedef struct
  453. {
  454.     DWORD   dwSize;                         // Size of this structure
  455.     HRESULT hrResult;                       // Result of the Connect() call
  456. } DVMSG_CONNECTRESULT, *LPDVMSG_CONNECTRESULT, *PDVMSG_CONNECTRESULT;
  457.  
  458. //
  459. // A new player has entered the voice session
  460. // (DVMSGID_CREATEVOICEPLAYER)
  461. // 
  462. typedef struct
  463. {
  464.     DWORD   dwSize;                         // Size of this structure
  465.     DVID    dvidPlayer;                     // DVID of the player who joined
  466.     DWORD   dwFlags;                        // Player flags (DVPLAYERCAPS_...)
  467.     PVOID    pvPlayerContext;                // Context value for this player (user set)
  468. } DVMSG_CREATEVOICEPLAYER, *LPDVMSG_CREATEVOICEPLAYER, *PDVMSG_CREATEVOICEPLAYER;
  469.  
  470. //
  471. // A player has left the voice session
  472. // (DVMSGID_DELETEVOICEPLAYER)
  473. //
  474. typedef struct
  475. {
  476.     DWORD   dwSize;                         // Size of this structure
  477.     DVID    dvidPlayer;                     // DVID of the player who left
  478.     PVOID    pvPlayerContext;                // Context value for the player
  479. } DVMSG_DELETEVOICEPLAYER, *LPDVMSG_DELETEVOICEPLAYER, *PDVMSG_DELETEVOICEPLAYER;
  480.  
  481. //
  482. // Result of the Disconnect() call.  (If it wasn't called Async)
  483. // (DVMSGID_DISCONNECTRESULT)
  484. //
  485. typedef struct
  486. {
  487.     DWORD   dwSize;                         // Size of this structure
  488.     HRESULT hrResult;                       // Result of the Disconnect() call
  489. } DVMSG_DISCONNECTRESULT, *LPDVMSG_DISCONNECTRESULT, *PDVMSG_DISCONNECTRESULT;
  490.  
  491. // 
  492. // The voice session host has migrated.
  493. // (DVMSGID_HOSTMIGRATED) 
  494. //
  495. typedef struct
  496. {
  497.     DWORD                   dwSize;         // Size of this structure
  498.     DVID                    dvidNewHostID;  // DVID of the player who is now the host
  499.     LPDIRECTPLAYVOICESERVER pdvServerInterface;
  500.                                             // Pointer to the new host object (if local player is now host)
  501. } DVMSG_HOSTMIGRATED, *LPDVMSG_HOSTMIGRATED, *PDVMSG_HOSTMIGRATED;
  502.  
  503. //
  504. // The current input level / recording volume on the local machine
  505. // (DVMSGID_INPUTLEVEL)
  506. //
  507. typedef struct
  508. {
  509.     DWORD   dwSize;                         // Size of this structure
  510.     DWORD   dwPeakLevel;                    // Current peak level of the audio
  511.     LONG    lRecordVolume;                  // Current recording volume
  512.     PVOID    pvLocalPlayerContext;           // Context value for the local player
  513. } DVMSG_INPUTLEVEL, *LPDVMSG_INPUTLEVEL, *PDVMSG_INPUTLEVEL;
  514.  
  515. //
  516. // The local client is about to become the new host
  517. // (DVMSGID_LOCALHOSTSETUP)
  518. //
  519. typedef struct
  520. {
  521.     DWORD                dwSize;             // Size of this structure
  522.     PVOID                pvContext;            // Context value to be passed to Initialize() of new host object
  523.     PDVMESSAGEHANDLER    pMessageHandler;    // Message handler to be used by new host object
  524. } DVMSG_LOCALHOSTSETUP, *LPDVMSG_LOCALHOSTSETUP, *PDVMSG_LOCALHOSTSETUP;
  525.  
  526. //
  527. // The current output level for the combined output of all incoming streams.
  528. // (DVMSGID_OUTPUTLEVEL)
  529. //
  530. typedef struct
  531. {
  532.     DWORD   dwSize;                         // Size of this structure
  533.     DWORD   dwPeakLevel;                    // Current peak level of the output
  534.     LONG    lOutputVolume;                  // Current playback volume
  535.     PVOID    pvLocalPlayerContext;           // Context value for the local player
  536. } DVMSG_OUTPUTLEVEL, *LPDVMSG_OUTPUTLEVEL, *PDVMSG_OUTPUTLEVEL;
  537.  
  538. //
  539. // The current peak level of an individual player's incoming audio stream as it is
  540. // being played back.
  541. // (DVMSGID_PLAYEROUTPUTLEVEL)
  542. //
  543. typedef struct
  544. {
  545.     DWORD   dwSize;                         // Size of this structure
  546.     DVID    dvidSourcePlayerID;                   // DVID of the player
  547.     DWORD   dwPeakLevel;                    // Peak level of the player's stream
  548.     PVOID    pvPlayerContext;                // Context value for the player
  549. } DVMSG_PLAYEROUTPUTLEVEL, *LPDVMSG_PLAYEROUTPUTLEVEL, *PDVMSG_PLAYEROUTPUTLEVEL;
  550.  
  551. // 
  552. // An audio stream from the specified player has started playing back on the local client.
  553. // (DVMSGID_PLAYERVOICESTART).
  554. //
  555. typedef struct
  556. {
  557.     DWORD   dwSize;                         // Size of this structure
  558.     DVID    dvidSourcePlayerID;             // DVID of the Player 
  559.     PVOID    pvPlayerContext;                // Context value for this player
  560. } DVMSG_PLAYERVOICESTART, *LPDVMSG_PLAYERVOICESTART, *PDVMSG_PLAYERVOICESTART;
  561.  
  562. //
  563. // The audio stream from the specified player has stopped playing back on the local client.
  564. // (DVMSGID_PLAYERVOICESTOP)
  565. //
  566. typedef struct
  567. {
  568.     DWORD   dwSize;                         // Size of this structure
  569.     DVID    dvidSourcePlayerID;             // DVID of the player
  570.     PVOID    pvPlayerContext;                // Context value for this player
  571. } DVMSG_PLAYERVOICESTOP, *LPDVMSG_PLAYERVOICESTOP, *PDVMSG_PLAYERVOICESTOP;
  572.  
  573. // 
  574. // Transmission has started on the local machine
  575. // (DVMSGID_RECORDSTART)
  576. //
  577. typedef struct
  578. {
  579.     DWORD   dwSize;                         // Size of this structure
  580.     DWORD   dwPeakLevel;                    // Peak level that caused transmission to start
  581.     PVOID    pvLocalPlayerContext;           // Context value for the local player
  582. } DVMSG_RECORDSTART, *LPDVMSG_RECORDSTART, *PDVMSG_RECORDSTART;
  583.  
  584. // 
  585. // Transmission has stopped on the local machine
  586. // (DVMSGID_RECORDSTOP)
  587. // 
  588. typedef struct
  589. {
  590.     DWORD   dwSize;                         // Size of this structure
  591.     DWORD   dwPeakLevel;                    // Peak level that caused transmission to stop
  592.     PVOID    pvLocalPlayerContext;           // Context value for the local player
  593. } DVMSG_RECORDSTOP, *LPDVMSG_RECORDSTOP, *PDVMSG_RECORDSTOP;
  594.  
  595. // 
  596. // The voice session has been lost
  597. // (DVMSGID_SESSIONLOST)
  598. //
  599. typedef struct
  600. {
  601.     DWORD   dwSize;                         // Size of this structure
  602.     HRESULT hrResult;                        // Reason the session was disconnected
  603. } DVMSG_SESSIONLOST, *LPDVMSG_SESSIONLOST, *PDVMSG_SESSIONLOST;
  604.  
  605. //
  606. // The target list has been updated for the local client
  607. // (DVMSGID_SETTARGETS)
  608. //
  609. typedef struct
  610. {
  611.     DWORD   dwSize;                         // Size of this structure
  612.     DWORD   dwNumTargets;                   // # of targets 
  613.     PDVID   pdvidTargets;                   // An array of DVIDs specifying the current targets
  614. } DVMSG_SETTARGETS, *LPDVMSG_SETTARGETS, *PDVMSG_SETTARGETS;
  615.  
  616.  
  617. /****************************************************************************
  618.  *
  619.  * DirectPlayVoice Functions
  620.  *
  621.  ****************************************************************************/
  622.  
  623. extern HRESULT WINAPI DirectPlayVoiceCreate( const GUID * pcIID, void **ppvInterface, IUnknown *pUnknown); 
  624.  
  625. /****************************************************************************
  626.  *
  627.  * DirectPlay8 Application Interfaces
  628.  *
  629.  ****************************************************************************/
  630.  
  631. #undef INTERFACE
  632. #define INTERFACE IDirectPlayVoiceClient
  633. DECLARE_INTERFACE_( IDirectPlayVoiceClient, IUnknown )
  634. {
  635.     /*** IUnknown methods ***/
  636.     STDMETHOD(QueryInterface)(THIS_ REFIID riid, PVOID *ppvObj) PURE;
  637.     STDMETHOD_(ULONG,AddRef)(THIS) PURE;
  638.     STDMETHOD_(ULONG,Release)(THIS) PURE;
  639.     /*** IDirectPlayVoiceClient methods ***/
  640.     STDMETHOD_(HRESULT, Initialize)   (THIS_ LPUNKNOWN, PDVMESSAGEHANDLER, PVOID, PDWORD, DWORD ) PURE;
  641.     STDMETHOD_(HRESULT, Connect)      (THIS_ PDVSOUNDDEVICECONFIG, PDVCLIENTCONFIG, DWORD ) PURE;
  642.     STDMETHOD_(HRESULT, Disconnect)   (THIS_ DWORD ) PURE;
  643.     STDMETHOD_(HRESULT, GetSessionDesc)(THIS_ PDVSESSIONDESC ) PURE;
  644.     STDMETHOD_(HRESULT, GetClientConfig)(THIS_ PDVCLIENTCONFIG ) PURE;
  645.     STDMETHOD_(HRESULT, SetClientConfig)(THIS_ PDVCLIENTCONFIG ) PURE;
  646.     STDMETHOD_(HRESULT, GetCaps)         (THIS_ PDVCAPS ) PURE;
  647.     STDMETHOD_(HRESULT, GetCompressionTypes)( THIS_ PVOID, PDWORD, PDWORD, DWORD ) PURE;
  648.     STDMETHOD_(HRESULT, SetTransmitTargets)( THIS_ PDVID, DWORD, DWORD ) PURE;
  649.     STDMETHOD_(HRESULT, GetTransmitTargets)( THIS_ PDVID, PDWORD, DWORD ) PURE;
  650.     STDMETHOD_(HRESULT, Create3DSoundBuffer)( THIS_ DVID, LPDIRECTSOUNDBUFFER, DWORD, DWORD, LPDIRECTSOUND3DBUFFER * ) PURE;
  651.     STDMETHOD_(HRESULT, Delete3DSoundBuffer)( THIS_ DVID, LPDIRECTSOUND3DBUFFER * ) PURE;
  652.     STDMETHOD_(HRESULT, SetNotifyMask)( THIS_ PDWORD, DWORD ) PURE;
  653.     STDMETHOD_(HRESULT, GetSoundDeviceConfig)( THIS_ PDVSOUNDDEVICECONFIG, PDWORD ) PURE;
  654. };
  655.  
  656.  
  657. #undef INTERFACE
  658. #define INTERFACE IDirectPlayVoiceServer
  659. DECLARE_INTERFACE_( IDirectPlayVoiceServer, IUnknown )
  660. {
  661.     /*** IUnknown methods ***/
  662.     STDMETHOD(QueryInterface)       (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
  663.     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
  664.     STDMETHOD_(ULONG,Release)       (THIS) PURE;
  665.     /*** IDirectPlayVoiceServer methods ***/
  666.     STDMETHOD_(HRESULT, Initialize)   (THIS_ LPUNKNOWN, PDVMESSAGEHANDLER, PVOID, LPDWORD, DWORD ) PURE;
  667.     STDMETHOD_(HRESULT, StartSession)  (THIS_ PDVSESSIONDESC, DWORD ) PURE;
  668.     STDMETHOD_(HRESULT, StopSession)   (THIS_ DWORD ) PURE;
  669.     STDMETHOD_(HRESULT, GetSessionDesc)(THIS_ PDVSESSIONDESC ) PURE;
  670.     STDMETHOD_(HRESULT, SetSessionDesc)(THIS_ PDVSESSIONDESC ) PURE;
  671.     STDMETHOD_(HRESULT, GetCaps)         (THIS_ PDVCAPS ) PURE;
  672.     STDMETHOD_(HRESULT, GetCompressionTypes)( THIS_ PVOID, PDWORD, PDWORD, DWORD ) PURE;
  673.     STDMETHOD_(HRESULT, SetTransmitTargets)( THIS_ DVID, PDVID, DWORD, DWORD ) PURE;
  674.     STDMETHOD_(HRESULT, GetTransmitTargets)( THIS_ DVID, PDVID, PDWORD, DWORD ) PURE;
  675.     STDMETHOD_(HRESULT, SetNotifyMask)( THIS_ PDWORD, DWORD ) PURE;
  676. };
  677.  
  678. #undef INTERFACE
  679. #define INTERFACE IDirectPlayVoiceTest
  680. DECLARE_INTERFACE_( IDirectPlayVoiceTest, IUnknown )
  681. {
  682.     /*** IUnknown methods ***/
  683.     STDMETHOD(QueryInterface)       (THIS_ REFIID riid, PVOID * ppvObj) PURE;
  684.     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
  685.     STDMETHOD_(ULONG,Release)       (THIS) PURE;
  686.     /*** IDirectPlayVoiceTest methods ***/
  687.     STDMETHOD_(HRESULT, CheckAudioSetup) (THIS_ const GUID *,  const GUID * , HWND, DWORD ) PURE;
  688. };
  689.  
  690. #if !defined(__cplusplus) || defined(CINTERFACE)
  691.  
  692. #define IDirectPlayVoiceClient_QueryInterface(p,a,b)        (p)->lpVtbl->QueryInterface(p,a,b)
  693. #define IDirectPlayVoiceClient_AddRef(p)                    (p)->lpVtbl->AddRef(p)
  694. #define IDirectPlayVoiceClient_Release(p)                   (p)->lpVtbl->Release(p)
  695.  
  696. #define IDirectPlayVoiceClient_Initialize(p,a,b,c,d,e)      (p)->lpVtbl->Initialize(p,a,b,c,d,e)
  697. #define IDirectPlayVoiceClient_Connect(p,a,b,c)             (p)->lpVtbl->Connect(p,a,b,c)
  698. #define IDirectPlayVoiceClient_Disconnect(p,a)              (p)->lpVtbl->Disconnect(p,a)
  699. #define IDirectPlayVoiceClient_GetSessionDesc(p,a)          (p)->lpVtbl->GetSessionDesc(p,a)
  700. #define IDirectPlayVoiceClient_GetClientConfig(p,a)         (p)->lpVtbl->GetClientConfig(p,a)
  701. #define IDirectPlayVoiceClient_SetClientConfig(p,a)         (p)->lpVtbl->SetClientConfig(p,a)
  702. #define IDirectPlayVoiceClient_GetCaps(p,a)                 (p)->lpVtbl->GetCaps(p,a)
  703. #define IDirectPlayVoiceClient_GetCompressionTypes(p,a,b,c,d) (p)->lpVtbl->GetCompressionTypes(p,a,b,c,d)
  704. #define IDirectPlayVoiceClient_SetTransmitTargets(p,a,b,c)  (p)->lpVtbl->SetTransmitTargets(p,a,b,c)
  705. #define IDirectPlayVoiceClient_GetTransmitTargets(p,a,b,c)  (p)->lpVtbl->GetTransmitTargets(p,a,b,c)
  706. #define IDirectPlayVoiceClient_Create3DSoundBuffer(p,a,b,c,d,e)   (p)->lpVtbl->Create3DSoundBuffer(p,a,b,c,d,e)
  707. #define IDirectPlayVoiceClient_Delete3DSoundBuffer(p,a,b)   (p)->lpVtbl->Delete3DSoundBuffer(p,a,b)
  708. #define IDirectPlayVoiceClient_SetNotifyMask(p,a,b)         (p)->lpVtbl->SetNotifyMask(p,a,b)
  709. #define IDirectPlayVoiceClient_GetSoundDeviceConfig(p,a,b)  (p)->lpVtbl->GetSoundDeviceConfig(p,a,b)
  710.  
  711. #define IDirectPlayVoiceServer_QueryInterface(p,a,b)        (p)->lpVtbl->QueryInterface(p,a,b)
  712. #define IDirectPlayVoiceServer_AddRef(p)                    (p)->lpVtbl->AddRef(p)
  713. #define IDirectPlayVoiceServer_Release(p)                   (p)->lpVtbl->Release(p)
  714.  
  715. #define IDirectPlayVoiceServer_Initialize(p,a,b,c,d,e)      (p)->lpVtbl->Initialize(p,a,b,c,d,e)
  716. #define IDirectPlayVoiceServer_StartSession(p,a,b)          (p)->lpVtbl->StartSession(p,a,b)
  717. #define IDirectPlayVoiceServer_StopSession(p,a)             (p)->lpVtbl->StopSession(p,a)
  718. #define IDirectPlayVoiceServer_GetSessionDesc(p,a)          (p)->lpVtbl->GetSessionDesc(p,a)
  719. #define IDirectPlayVoiceServer_SetSessionDesc(p,a)          (p)->lpVtbl->SetSessionDesc(p,a)
  720. #define IDirectPlayVoiceServer_GetCaps(p,a)                 (p)->lpVtbl->GetCaps(p,a)
  721. #define IDirectPlayVoiceServer_GetCompressionTypes(p,a,b,c,d) (p)->lpVtbl->GetCompressionTypes(p,a,b,c,d)
  722. #define IDirectPlayVoiceServer_SetTransmitTargets(p,a,b,c,d)    (p)->lpVtbl->SetTransmitTargets(p,a,b,c,d)
  723. #define IDirectPlayVoiceServer_GetTransmitTargets(p,a,b,c,d)    (p)->lpVtbl->GetTransmitTargets(p,a,b,c,d)
  724. #define IDirectPlayVoiceServer_SetNotifyMask(p,a,b)         (p)->lpVtbl->SetNotifyMask(p,a,b)
  725. #define IDirectPlayVoiceTest_QueryInterface(p,a,b)          (p)->lpVtbl->QueryInterface(p,a,b)
  726. #define IDirectPlayVoiceTest_AddRef(p)                      (p)->lpVtbl->AddRef(p)
  727. #define IDirectPlayVoiceTest_Release(p)                        (p)->lpVtbl->Release(p)
  728. #define IDirectPlayVoiceTest_CheckAudioSetup(p,a,b,c,d)     (p)->lpVtbl->CheckAudioSetup(p,a,b,c,d)
  729.  
  730.  
  731. #else /* C++ */
  732.  
  733. #define IDirectPlayVoiceClient_QueryInterface(p,a,b)        (p)->QueryInterface(a,b)
  734. #define IDirectPlayVoiceClient_AddRef(p)                    (p)->AddRef()
  735. #define IDirectPlayVoiceClient_Release(p)                   (p)->Release()
  736.  
  737. #define IDirectPlayVoiceClient_Initialize(p,a,b,c,d,e)      (p)->Initialize(a,b,c,d,e)
  738. #define IDirectPlayVoiceClient_Connect(p,a,b,c)             (p)->Connect(a,b,c)
  739. #define IDirectPlayVoiceClient_Disconnect(p,a)              (p)->Disconnect(a)
  740. #define IDirectPlayVoiceClient_GetSessionDesc(p,a)          (p)->GetSessionDesc(a)
  741. #define IDirectPlayVoiceClient_GetClientConfig(p,a)         (p)->GetClientConfig(a)
  742. #define IDirectPlayVoiceClient_SetClientConfig(p,a)         (p)->SetClientConfig(a)
  743. #define IDirectPlayVoiceClient_GetCaps(p,a)                 (p)->GetCaps(a)
  744. #define IDirectPlayVoiceClient_GetCompressionTypes(p,a,b,c,d) (p)->GetCompressionTypes(a,b,c,d)
  745. #define IDirectPlayVoiceClient_SetTransmitTargets(p,a,b,c)  (p)->SetTransmitTargets(a,b,c)
  746. #define IDirectPlayVoiceClient_GetTransmitTargets(p,a,b,c)  (p)->GetTransmitTargets(a,b,c)
  747. #define IDirectPlayVoiceClient_Create3DSoundBuffer(p,a,b,c,d,e)   (p)->Create3DSoundBuffer(a,b,c,d,e)
  748. #define IDirectPlayVoiceClient_Delete3DSoundBuffer(p,a,b)   (p)->Delete3DSoundBuffer(a,b)
  749. #define IDirectPlayVoiceClient_SetNotifyMask(p,a,b)         (p)->SetNotifyMask(a,b)
  750. #define IDirectPlayVoiceClient_GetSoundDeviceConfig(p,a,b)    (p)->GetSoundDeviceConfig(a,b)
  751.  
  752. #define IDirectPlayVoiceServer_QueryInterface(p,a,b)        (p)->QueryInterface(a,b)
  753. #define IDirectPlayVoiceServer_AddRef(p)                    (p)->AddRef()
  754. #define IDirectPlayVoiceServer_Release(p)                   (p)->Release()
  755.  
  756. #define IDirectPlayVoiceServer_Initialize(p,a,b,c,d,e)      (p)->Initialize(a,b,c,d,e)
  757. #define IDirectPlayVoiceServer_StartSession(p,a,b)          (p)->StartSession(a,b)
  758. #define IDirectPlayVoiceServer_StopSession(p,a)             (p)->StopSession(a)
  759. #define IDirectPlayVoiceServer_GetSessionDesc(p,a)            (p)->GetSessionDesc(a)
  760. #define IDirectPlayVoiceServer_SetSessionDesc(p,a)            (p)->SetSessionDesc(a)
  761. #define IDirectPlayVoiceServer_GetCaps(p,a)                 (p)->GetCaps(a)
  762. #define IDirectPlayVoiceServer_GetCompressionTypes(p,a,b,c,d) (p)->GetCompressionTypes(a,b,c,d)
  763. #define IDirectPlayVoiceServer_SetTransmitTargets(p,a,b,c,d) (p)->SetTransmitTargets(a,b,c,d)
  764. #define IDirectPlayVoiceServer_GetTransmitTargets(p,a,b,c,d) (p)->GetTransmitTargets(a,b,c,d)
  765. #define IDirectPlayVoiceServer_SetNotifyMask(p,a,b)         (p)->SetNotifyMask(a,b)
  766.  
  767. #define IDirectPlayVoiceTest_QueryInterface(p,a,b)          (p)->QueryInterface(a,b)
  768. #define IDirectPlayVoiceTest_AddRef(p)                      (p)->AddRef()
  769. #define IDirectPlayVoiceTest_Release(p)                     (p)->Release()
  770. #define IDirectPlayVoiceTest_CheckAudioSetup(p,a,b,c,d)     (p)->CheckAudioSetup(a,b,c,d)
  771.  
  772.  
  773. #endif
  774.  
  775.  
  776. /****************************************************************************
  777.  *
  778.  * DIRECTPLAYVOICE ERRORS
  779.  *
  780.  * Errors are represented by negative values and cannot be combined.
  781.  *
  782.  ****************************************************************************/
  783.  
  784. #define _FACDPV  0x15
  785. #define MAKE_DVHRESULT( code )          MAKE_HRESULT( 1, _FACDPV, code )
  786.  
  787. #define DV_OK                           S_OK
  788. #define DV_FULLDUPLEX                   MAKE_HRESULT( 0, _FACDPV,  0x0005 )
  789. #define DV_HALFDUPLEX                   MAKE_HRESULT( 0, _FACDPV,  0x000A )
  790. #define DV_PENDING                        MAKE_HRESULT( 0, _FACDPV,  0x0010 )
  791.  
  792. #define DVERR_BUFFERTOOSMALL            MAKE_DVHRESULT(  0x001E )
  793. #define DVERR_EXCEPTION                 MAKE_DVHRESULT(  0x004A )
  794. #define DVERR_GENERIC                   E_FAIL
  795. #define DVERR_INVALIDFLAGS              MAKE_DVHRESULT( 0x0078 )
  796. #define DVERR_INVALIDOBJECT             MAKE_DVHRESULT( 0x0082 )
  797. #define DVERR_INVALIDPARAM              E_INVALIDARG
  798. #define DVERR_INVALIDPLAYER             MAKE_DVHRESULT( 0x0087 )
  799. #define DVERR_INVALIDGROUP              MAKE_DVHRESULT( 0x0091 )
  800. #define DVERR_INVALIDHANDLE             MAKE_DVHRESULT( 0x0096 )
  801. #define DVERR_OUTOFMEMORY               E_OUTOFMEMORY
  802. #define DVERR_PENDING                   DV_PENDING
  803. #define DVERR_NOTSUPPORTED              E_NOTIMPL
  804. #define DVERR_NOINTERFACE               E_NOINTERFACE
  805. #define DVERR_SESSIONLOST               MAKE_DVHRESULT( 0x012C )
  806. #define DVERR_NOVOICESESSION            MAKE_DVHRESULT( 0x012E )
  807. #define DVERR_CONNECTIONLOST            MAKE_DVHRESULT( 0x0168 )
  808. #define DVERR_NOTINITIALIZED            MAKE_DVHRESULT( 0x0169 )
  809. #define DVERR_CONNECTED                 MAKE_DVHRESULT( 0x016A )
  810. #define DVERR_NOTCONNECTED              MAKE_DVHRESULT( 0x016B )
  811. #define DVERR_CONNECTABORTING           MAKE_DVHRESULT( 0x016E )
  812. #define DVERR_NOTALLOWED                MAKE_DVHRESULT( 0x016F )
  813. #define DVERR_INVALIDTARGET             MAKE_DVHRESULT( 0x0170 )
  814. #define DVERR_TRANSPORTNOTHOST          MAKE_DVHRESULT( 0x0171 )
  815. #define DVERR_COMPRESSIONNOTSUPPORTED   MAKE_DVHRESULT( 0x0172 )
  816. #define DVERR_ALREADYPENDING            MAKE_DVHRESULT( 0x0173 )
  817. #define DVERR_SOUNDINITFAILURE          MAKE_DVHRESULT( 0x0174 )
  818. #define DVERR_TIMEOUT                   MAKE_DVHRESULT( 0x0175 )
  819. #define DVERR_CONNECTABORTED            MAKE_DVHRESULT( 0x0176 )
  820. #define DVERR_NO3DSOUND                 MAKE_DVHRESULT( 0x0177 )
  821. #define DVERR_ALREADYBUFFERED            MAKE_DVHRESULT( 0x0178 )
  822. #define DVERR_NOTBUFFERED               MAKE_DVHRESULT( 0x0179 )
  823. #define DVERR_HOSTING                   MAKE_DVHRESULT( 0x017A )
  824. #define DVERR_NOTHOSTING                MAKE_DVHRESULT( 0x017B )
  825. #define DVERR_INVALIDDEVICE             MAKE_DVHRESULT( 0x017C )
  826. #define DVERR_RECORDSYSTEMERROR         MAKE_DVHRESULT( 0x017D )
  827. #define DVERR_PLAYBACKSYSTEMERROR       MAKE_DVHRESULT( 0x017E )
  828. #define DVERR_SENDERROR                 MAKE_DVHRESULT( 0x017F )
  829. #define DVERR_USERCANCEL                MAKE_DVHRESULT( 0x0180 )
  830. #define DVERR_RUNSETUP                  MAKE_DVHRESULT( 0x0183 )
  831. #define DVERR_INCOMPATIBLEVERSION       MAKE_DVHRESULT( 0x0184 )
  832. #define DVERR_INITIALIZED               MAKE_DVHRESULT( 0x0187 )
  833. #define DVERR_INVALIDPOINTER            E_POINTER
  834. #define DVERR_NOTRANSPORT               MAKE_DVHRESULT( 0x0188 )
  835. #define DVERR_NOCALLBACK                MAKE_DVHRESULT( 0x0189 )
  836. #define DVERR_TRANSPORTNOTINIT          MAKE_DVHRESULT( 0x018A )
  837. #define DVERR_TRANSPORTNOSESSION        MAKE_DVHRESULT( 0x018B )
  838. #define DVERR_TRANSPORTNOPLAYER         MAKE_DVHRESULT( 0x018C )
  839. #define DVERR_USERBACK                  MAKE_DVHRESULT( 0x018D )
  840. #define DVERR_NORECVOLAVAILABLE         MAKE_DVHRESULT( 0x018E )
  841. #define DVERR_INVALIDBUFFER                MAKE_DVHRESULT( 0x018F )
  842. #define DVERR_LOCKEDBUFFER                MAKE_DVHRESULT( 0x0190 )
  843.  
  844. #ifdef __cplusplus
  845. }
  846. #endif
  847.  
  848. #endif
  849.  
  850.  
  851.