You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
857 lines
33 KiB
857 lines
33 KiB
/*==========================================================================; |
|
* |
|
* Copyright (C) 1999 Microsoft Corporation. All Rights Reserved. |
|
* |
|
* File: dpvoice.h |
|
* Content: DirectPlayVoice include file |
|
***************************************************************************/ |
|
|
|
#ifndef __DVOICE__ |
|
#define __DVOICE__ |
|
|
|
#include <ole2.h> // for DECLARE_INTERFACE and HRESULT |
|
#include <mmsystem.h> |
|
#include <mmreg.h> |
|
#include <msacm.h> |
|
#include "dsound.h" |
|
|
|
#ifdef __cplusplus |
|
extern "C" { |
|
#endif |
|
|
|
|
|
/**************************************************************************** |
|
* |
|
* DirectPlayVoice CLSIDs |
|
* |
|
****************************************************************************/ |
|
|
|
|
|
// {B9F3EB85-B781-4ac1-8D90-93A05EE37D7D} |
|
DEFINE_GUID(CLSID_DirectPlayVoiceClient, |
|
0xb9f3eb85, 0xb781, 0x4ac1, 0x8d, 0x90, 0x93, 0xa0, 0x5e, 0xe3, 0x7d, 0x7d); |
|
|
|
// {D3F5B8E6-9B78-4a4c-94EA-CA2397B663D3} |
|
DEFINE_GUID(CLSID_DirectPlayVoiceServer, |
|
0xd3f5b8e6, 0x9b78, 0x4a4c, 0x94, 0xea, 0xca, 0x23, 0x97, 0xb6, 0x63, 0xd3); |
|
|
|
// {0F0F094B-B01C-4091-A14D-DD0CD807711A} |
|
DEFINE_GUID(CLSID_DirectPlayVoiceTest, |
|
0xf0f094b, 0xb01c, 0x4091, 0xa1, 0x4d, 0xdd, 0xc, 0xd8, 0x7, 0x71, 0x1a); |
|
|
|
/**************************************************************************** |
|
* |
|
* DirectPlayVoice Interface IIDs |
|
* |
|
****************************************************************************/ |
|
|
|
|
|
// {1DFDC8EA-BCF7-41d6-B295-AB64B3B23306} |
|
DEFINE_GUID(IID_IDirectPlayVoiceClient, |
|
0x1dfdc8ea, 0xbcf7, 0x41d6, 0xb2, 0x95, 0xab, 0x64, 0xb3, 0xb2, 0x33, 0x6); |
|
|
|
// {FAA1C173-0468-43b6-8A2A-EA8A4F2076C9} |
|
DEFINE_GUID(IID_IDirectPlayVoiceServer, |
|
0xfaa1c173, 0x468, 0x43b6, 0x8a, 0x2a, 0xea, 0x8a, 0x4f, 0x20, 0x76, 0xc9); |
|
|
|
// {D26AF734-208B-41da-8224-E0CE79810BE1} |
|
DEFINE_GUID(IID_IDirectPlayVoiceTest, |
|
0xd26af734, 0x208b, 0x41da, 0x82, 0x24, 0xe0, 0xce, 0x79, 0x81, 0xb, 0xe1); |
|
|
|
/**************************************************************************** |
|
* |
|
* DirectPlayVoice Compression Type GUIDs |
|
* |
|
****************************************************************************/ |
|
|
|
// MS-ADPCM 32.8 kbit/s |
|
// |
|
// {699B52C1-A885-46a8-A308-97172419ADC7} |
|
DEFINE_GUID(DPVCTGUID_ADPCM, |
|
0x699b52c1, 0xa885, 0x46a8, 0xa3, 0x8, 0x97, 0x17, 0x24, 0x19, 0xad, 0xc7); |
|
|
|
// Microsoft GSM 6.10 13 kbit/s |
|
// |
|
// {24768C60-5A0D-11d3-9BE4-525400D985E7} |
|
DEFINE_GUID(DPVCTGUID_GSM, |
|
0x24768c60, 0x5a0d, 0x11d3, 0x9b, 0xe4, 0x52, 0x54, 0x0, 0xd9, 0x85, 0xe7); |
|
|
|
// MS-PCM 64 kbit/s |
|
// |
|
// {8DE12FD4-7CB3-48ce-A7E8-9C47A22E8AC5} |
|
DEFINE_GUID(DPVCTGUID_NONE, |
|
0x8de12fd4, 0x7cb3, 0x48ce, 0xa7, 0xe8, 0x9c, 0x47, 0xa2, 0x2e, 0x8a, 0xc5); |
|
|
|
// Voxware SC03 3.2kbit/s |
|
// |
|
// {7D82A29B-2242-4f82-8F39-5D1153DF3E41} |
|
DEFINE_GUID(DPVCTGUID_SC03, |
|
0x7d82a29b, 0x2242, 0x4f82, 0x8f, 0x39, 0x5d, 0x11, 0x53, 0xdf, 0x3e, 0x41); |
|
|
|
// Voxware SC06 6.4kbit/s |
|
// |
|
// {53DEF900-7168-4633-B47F-D143916A13C7} |
|
DEFINE_GUID(DPVCTGUID_SC06, |
|
0x53def900, 0x7168, 0x4633, 0xb4, 0x7f, 0xd1, 0x43, 0x91, 0x6a, 0x13, 0xc7); |
|
|
|
// TrueSpeech(TM) 8.6 kbit/s |
|
// |
|
// {D7954361-5A0B-11d3-9BE4-525400D985E7} |
|
DEFINE_GUID(DPVCTGUID_TRUESPEECH, |
|
0xd7954361, 0x5a0b, 0x11d3, 0x9b, 0xe4, 0x52, 0x54, 0x0, 0xd9, 0x85, 0xe7); |
|
|
|
// Voxware VR12 1.4kbit/s |
|
// |
|
// {FE44A9FE-8ED4-48bf-9D66-1B1ADFF9FF6D} |
|
DEFINE_GUID(DPVCTGUID_VR12, |
|
0xfe44a9fe, 0x8ed4, 0x48bf, 0x9d, 0x66, 0x1b, 0x1a, 0xdf, 0xf9, 0xff, 0x6d); |
|
|
|
// Define the default compression type |
|
#define DPVCTGUID_DEFAULT DPVCTGUID_SC03 |
|
|
|
/**************************************************************************** |
|
* |
|
* DirectPlayVoice Interface Pointer definitions |
|
* |
|
****************************************************************************/ |
|
|
|
typedef struct IDirectPlayVoiceClient FAR *LPDIRECTPLAYVOICECLIENT, *PDIRECTPLAYVOICECLIENT; |
|
typedef struct IDirectPlayVoiceServer FAR *LPDIRECTPLAYVOICESERVER, *PDIRECTPLAYVOICESERVER; |
|
typedef struct IDirectPlayVoiceTest FAR *LPDIRECTPLAYVOICETEST, *PDIRECTPLAYVOICETEST; |
|
|
|
/**************************************************************************** |
|
* |
|
* DirectPlayVoice Callback Functions |
|
* |
|
****************************************************************************/ |
|
typedef HRESULT (FAR PASCAL *PDVMESSAGEHANDLER)( |
|
PVOID pvUserContext, |
|
DWORD dwMessageType, |
|
LPVOID lpMessage |
|
); |
|
|
|
typedef PDVMESSAGEHANDLER LPDVMESSAGEHANDLER; |
|
|
|
/**************************************************************************** |
|
* |
|
* DirectPlayVoice Datatypes (Non-Structure / Non-Message) |
|
* |
|
****************************************************************************/ |
|
|
|
typedef DWORD DVID, *LPDVID, *PDVID; |
|
|
|
/**************************************************************************** |
|
* |
|
* DirectPlayVoice Message Types |
|
* |
|
****************************************************************************/ |
|
|
|
#define DVMSGID_BASE 0x0000 |
|
|
|
#define DVMSGID_MINBASE (DVMSGID_CREATEVOICEPLAYER) |
|
#define DVMSGID_CREATEVOICEPLAYER (DVMSGID_BASE+0x0001) |
|
#define DVMSGID_DELETEVOICEPLAYER (DVMSGID_BASE+0x0002) |
|
#define DVMSGID_SESSIONLOST (DVMSGID_BASE+0x0003) |
|
#define DVMSGID_PLAYERVOICESTART (DVMSGID_BASE+0x0004) |
|
#define DVMSGID_PLAYERVOICESTOP (DVMSGID_BASE+0x0005) |
|
#define DVMSGID_RECORDSTART (DVMSGID_BASE+0x0006) |
|
#define DVMSGID_RECORDSTOP (DVMSGID_BASE+0x0007) |
|
#define DVMSGID_CONNECTRESULT (DVMSGID_BASE+0x0008) |
|
#define DVMSGID_DISCONNECTRESULT (DVMSGID_BASE+0x0009) |
|
#define DVMSGID_INPUTLEVEL (DVMSGID_BASE+0x000A) |
|
#define DVMSGID_OUTPUTLEVEL (DVMSGID_BASE+0x000B) |
|
#define DVMSGID_HOSTMIGRATED (DVMSGID_BASE+0x000C) |
|
#define DVMSGID_SETTARGETS (DVMSGID_BASE+0x000D) |
|
#define DVMSGID_PLAYEROUTPUTLEVEL (DVMSGID_BASE+0x000E) |
|
#define DVMSGID_LOSTFOCUS (DVMSGID_BASE+0x0010) |
|
#define DVMSGID_GAINFOCUS (DVMSGID_BASE+0x0011) |
|
#define DVMSGID_LOCALHOSTSETUP (DVMSGID_BASE+0x0012) |
|
#define DVMSGID_MAXBASE (DVMSGID_LOCALHOSTSETUP) |
|
|
|
/**************************************************************************** |
|
* |
|
* DirectPlayVoice Constants |
|
* |
|
****************************************************************************/ |
|
|
|
// |
|
// Buffer Aggresiveness Value Ranges |
|
// |
|
#define DVBUFFERAGGRESSIVENESS_MIN 0x00000001 |
|
#define DVBUFFERAGGRESSIVENESS_MAX 0x00000064 |
|
#define DVBUFFERAGGRESSIVENESS_DEFAULT 0x00000000 |
|
|
|
// |
|
// Buffer Quality Value Ranges |
|
// |
|
#define DVBUFFERQUALITY_MIN 0x00000001 |
|
#define DVBUFFERQUALITY_MAX 0x00000064 |
|
#define DVBUFFERQUALITY_DEFAULT 0x00000000 |
|
|
|
#define DVID_SYS 0 |
|
|
|
// |
|
// Used to identify the session host in client/server |
|
// |
|
#define DVID_SERVERPLAYER 1 |
|
|
|
// |
|
// Used to target all players |
|
// |
|
#define DVID_ALLPLAYERS 0 |
|
|
|
// |
|
// Used to identify the main buffer |
|
// |
|
#define DVID_REMAINING 0xFFFFFFFF |
|
|
|
// |
|
// Input level range |
|
// |
|
#define DVINPUTLEVEL_MIN 0x00000000 |
|
#define DVINPUTLEVEL_MAX 0x00000063 // 99 decimal |
|
|
|
#define DVNOTIFYPERIOD_MINPERIOD 20 |
|
|
|
|
|
#define DVPLAYBACKVOLUME_DEFAULT DSBVOLUME_MAX |
|
|
|
#define DVRECORDVOLUME_LAST 0x00000001 |
|
|
|
|
|
// |
|
// Use the default value |
|
// |
|
#define DVTHRESHOLD_DEFAULT 0xFFFFFFFF |
|
|
|
// |
|
// Threshold Ranges |
|
// |
|
#define DVTHRESHOLD_MIN 0x00000000 |
|
#define DVTHRESHOLD_MAX 0x00000063 // 99 decimal |
|
|
|
// |
|
// Threshold field is not used |
|
// |
|
#define DVTHRESHOLD_UNUSED 0xFFFFFFFE |
|
|
|
// |
|
// Session Types |
|
// |
|
#define DVSESSIONTYPE_PEER 0x00000001 |
|
#define DVSESSIONTYPE_MIXING 0x00000002 |
|
#define DVSESSIONTYPE_FORWARDING 0x00000003 |
|
#define DVSESSIONTYPE_ECHO 0x00000004 |
|
|
|
/**************************************************************************** |
|
* |
|
* DirectPlayVoice Flags |
|
* |
|
****************************************************************************/ |
|
|
|
|
|
// |
|
// Enable automatic adjustment of the recording volume |
|
// |
|
#define DVCLIENTCONFIG_AUTORECORDVOLUME 0x00000008 |
|
|
|
// |
|
// Enable automatic voice activation |
|
// |
|
#define DVCLIENTCONFIG_AUTOVOICEACTIVATED 0x00000020 |
|
|
|
// |
|
// Enable echo suppression |
|
// |
|
#define DVCLIENTCONFIG_ECHOSUPPRESSION 0x08000000 |
|
|
|
// |
|
// Voice Activation manual mode |
|
// |
|
#define DVCLIENTCONFIG_MANUALVOICEACTIVATED 0x00000004 |
|
|
|
// |
|
// Only playback voices that have buffers created for them |
|
// |
|
#define DVCLIENTCONFIG_MUTEGLOBAL 0x00000010 |
|
|
|
// |
|
// Mute the playback |
|
// |
|
#define DVCLIENTCONFIG_PLAYBACKMUTE 0x00000002 |
|
|
|
// |
|
// Mute the recording |
|
// |
|
#define DVCLIENTCONFIG_RECORDMUTE 0x00000001 |
|
|
|
// |
|
// Complete the operation before returning |
|
// |
|
#define DVFLAGS_SYNC 0x00000001 |
|
|
|
// |
|
// Just check to see if wizard has been run, and if so what it's results were |
|
// |
|
#define DVFLAGS_QUERYONLY 0x00000002 |
|
|
|
// |
|
// Shutdown the voice session without migrating the host |
|
// |
|
#define DVFLAGS_NOHOSTMIGRATE 0x00000008 |
|
|
|
// |
|
// Allow the back button to be enabled in the wizard |
|
// |
|
#define DVFLAGS_ALLOWBACK 0x00000010 |
|
|
|
// |
|
// Disable host migration in the voice session |
|
// |
|
#define DVSESSION_NOHOSTMIGRATION 0x00000001 |
|
|
|
// |
|
// Server controlled targetting |
|
// |
|
#define DVSESSION_SERVERCONTROLTARGET 0x00000002 |
|
|
|
// |
|
// Use DirectSound Normal Mode instead of priority |
|
// |
|
#define DVSOUNDCONFIG_NORMALMODE 0x00000001 |
|
|
|
// |
|
// Automatically select the microphone |
|
// |
|
#define DVSOUNDCONFIG_AUTOSELECT 0x00000002 |
|
|
|
// |
|
// Run in half duplex mode |
|
// |
|
#define DVSOUNDCONFIG_HALFDUPLEX 0x00000004 |
|
|
|
// |
|
// No volume controls are available for the recording device |
|
// |
|
#define DVSOUNDCONFIG_NORECVOLAVAILABLE 0x00000010 |
|
|
|
// |
|
// Disable capture sharing |
|
// |
|
#define DVSOUNDCONFIG_NOFOCUS 0x20000000 |
|
|
|
// |
|
// Set system conversion quality to high |
|
// |
|
#define DVSOUNDCONFIG_SETCONVERSIONQUALITY 0x00000008 |
|
|
|
// |
|
// Enable strict focus mode |
|
// |
|
#define DVSOUNDCONFIG_STRICTFOCUS 0x40000000 |
|
|
|
// |
|
// Player is in half duplex mode |
|
// |
|
#define DVPLAYERCAPS_HALFDUPLEX 0x00000001 |
|
|
|
// |
|
// Specifies that player is the local player |
|
// |
|
#define DVPLAYERCAPS_LOCAL 0x00000002 |
|
|
|
/**************************************************************************** |
|
* |
|
* DirectPlayVoice Structures (Non-Message) |
|
* |
|
****************************************************************************/ |
|
|
|
|
|
// |
|
// DirectPlayVoice Caps |
|
// (GetCaps / SetCaps) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
DWORD dwFlags; // Caps flags |
|
} DVCAPS, *LPDVCAPS, *PDVCAPS; |
|
|
|
// |
|
// DirectPlayVoice Client Configuration |
|
// (Connect / GetClientConfig) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
DWORD dwFlags; // Flags for client config (DVCLIENTCONFIG_...) |
|
LONG lRecordVolume; // Recording volume |
|
LONG lPlaybackVolume; // Playback volume |
|
DWORD dwThreshold; // Voice Activation Threshold |
|
DWORD dwBufferQuality; // Buffer quality |
|
DWORD dwBufferAggressiveness; // Buffer aggressiveness |
|
DWORD dwNotifyPeriod; // Period of notification messages (ms) |
|
} DVCLIENTCONFIG, *LPDVCLIENTCONFIG, *PDVCLIENTCONFIG; |
|
|
|
// |
|
// DirectPlayVoice Compression Type Information |
|
// (GetCompressionTypes) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
GUID guidType; // GUID that identifies this compression type |
|
LPWSTR lpszName; // String name of this compression type |
|
LPWSTR lpszDescription; // Description for this compression type |
|
DWORD dwFlags; // Flags for this compression type |
|
DWORD dwMaxBitsPerSecond; // Maximum # of bit/s this compression type uses |
|
} DVCOMPRESSIONINFO, *LPDVCOMPRESSIONINFO, *PDVCOMPRESSIONINFO; |
|
|
|
// |
|
// DirectPlayVoice Session Description |
|
// (Host / GetSessionDesc) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
DWORD dwFlags; // Session flags (DVSESSION_...) |
|
DWORD dwSessionType; // Session type (DVSESSIONTYPE_...) |
|
GUID guidCT; // Compression Type to use |
|
DWORD dwBufferQuality; // Buffer quality |
|
DWORD dwBufferAggressiveness; // Buffer aggresiveness |
|
} DVSESSIONDESC, *LPDVSESSIONDESC, *PDVSESSIONDESC; |
|
|
|
// |
|
// DirectPlayVoice Client Sound Device Configuration |
|
// (Connect / GetSoundDeviceConfig) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
DWORD dwFlags; // Flags for sound config (DVSOUNDCONFIG_...) |
|
GUID guidPlaybackDevice; // GUID of the playback device to use |
|
LPDIRECTSOUND lpdsPlaybackDevice; // DirectSound Object to use (optional) |
|
GUID guidCaptureDevice; // GUID of the capture device to use |
|
LPDIRECTSOUNDCAPTURE lpdsCaptureDevice; // DirectSoundCapture Object to use (optional) |
|
HWND hwndAppWindow; // HWND of your application's top-level window |
|
LPDIRECTSOUNDBUFFER lpdsMainBuffer; // DirectSoundBuffer to use for playback (optional) |
|
DWORD dwMainBufferFlags; // Flags to pass to Play() on the main buffer |
|
DWORD dwMainBufferPriority; // Priority to set when calling Play() on the main buffer |
|
} DVSOUNDDEVICECONFIG, *LPDVSOUNDDEVICECONFIG, *PDVSOUNDDEVICECONFIG; |
|
|
|
/**************************************************************************** |
|
* |
|
* DirectPlayVoice message handler call back structures |
|
* |
|
****************************************************************************/ |
|
|
|
// |
|
// Result of the Connect() call. (If it wasn't called Async) |
|
// (DVMSGID_CONNECTRESULT) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
HRESULT hrResult; // Result of the Connect() call |
|
} DVMSG_CONNECTRESULT, *LPDVMSG_CONNECTRESULT, *PDVMSG_CONNECTRESULT; |
|
|
|
// |
|
// A new player has entered the voice session |
|
// (DVMSGID_CREATEVOICEPLAYER) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
DVID dvidPlayer; // DVID of the player who joined |
|
DWORD dwFlags; // Player flags (DVPLAYERCAPS_...) |
|
PVOID pvPlayerContext; // Context value for this player (user set) |
|
} DVMSG_CREATEVOICEPLAYER, *LPDVMSG_CREATEVOICEPLAYER, *PDVMSG_CREATEVOICEPLAYER; |
|
|
|
// |
|
// A player has left the voice session |
|
// (DVMSGID_DELETEVOICEPLAYER) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
DVID dvidPlayer; // DVID of the player who left |
|
PVOID pvPlayerContext; // Context value for the player |
|
} DVMSG_DELETEVOICEPLAYER, *LPDVMSG_DELETEVOICEPLAYER, *PDVMSG_DELETEVOICEPLAYER; |
|
|
|
// |
|
// Result of the Disconnect() call. (If it wasn't called Async) |
|
// (DVMSGID_DISCONNECTRESULT) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
HRESULT hrResult; // Result of the Disconnect() call |
|
} DVMSG_DISCONNECTRESULT, *LPDVMSG_DISCONNECTRESULT, *PDVMSG_DISCONNECTRESULT; |
|
|
|
// |
|
// The voice session host has migrated. |
|
// (DVMSGID_HOSTMIGRATED) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
DVID dvidNewHostID; // DVID of the player who is now the host |
|
LPDIRECTPLAYVOICESERVER pdvServerInterface; |
|
// Pointer to the new host object (if local player is now host) |
|
} DVMSG_HOSTMIGRATED, *LPDVMSG_HOSTMIGRATED, *PDVMSG_HOSTMIGRATED; |
|
|
|
// |
|
// The current input level / recording volume on the local machine |
|
// (DVMSGID_INPUTLEVEL) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
DWORD dwPeakLevel; // Current peak level of the audio |
|
LONG lRecordVolume; // Current recording volume |
|
PVOID pvLocalPlayerContext; // Context value for the local player |
|
} DVMSG_INPUTLEVEL, *LPDVMSG_INPUTLEVEL, *PDVMSG_INPUTLEVEL; |
|
|
|
// |
|
// The local client is about to become the new host |
|
// (DVMSGID_LOCALHOSTSETUP) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
PVOID pvContext; // Context value to be passed to Initialize() of new host object |
|
PDVMESSAGEHANDLER pMessageHandler; // Message handler to be used by new host object |
|
} DVMSG_LOCALHOSTSETUP, *LPDVMSG_LOCALHOSTSETUP, *PDVMSG_LOCALHOSTSETUP; |
|
|
|
// |
|
// The current output level for the combined output of all incoming streams. |
|
// (DVMSGID_OUTPUTLEVEL) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
DWORD dwPeakLevel; // Current peak level of the output |
|
LONG lOutputVolume; // Current playback volume |
|
PVOID pvLocalPlayerContext; // Context value for the local player |
|
} DVMSG_OUTPUTLEVEL, *LPDVMSG_OUTPUTLEVEL, *PDVMSG_OUTPUTLEVEL; |
|
|
|
// |
|
// The current peak level of an individual player's incoming audio stream as it is |
|
// being played back. |
|
// (DVMSGID_PLAYEROUTPUTLEVEL) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
DVID dvidSourcePlayerID; // DVID of the player |
|
DWORD dwPeakLevel; // Peak level of the player's stream |
|
PVOID pvPlayerContext; // Context value for the player |
|
} DVMSG_PLAYEROUTPUTLEVEL, *LPDVMSG_PLAYEROUTPUTLEVEL, *PDVMSG_PLAYEROUTPUTLEVEL; |
|
|
|
// |
|
// An audio stream from the specified player has started playing back on the local client. |
|
// (DVMSGID_PLAYERVOICESTART). |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
DVID dvidSourcePlayerID; // DVID of the Player |
|
PVOID pvPlayerContext; // Context value for this player |
|
} DVMSG_PLAYERVOICESTART, *LPDVMSG_PLAYERVOICESTART, *PDVMSG_PLAYERVOICESTART; |
|
|
|
// |
|
// The audio stream from the specified player has stopped playing back on the local client. |
|
// (DVMSGID_PLAYERVOICESTOP) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
DVID dvidSourcePlayerID; // DVID of the player |
|
PVOID pvPlayerContext; // Context value for this player |
|
} DVMSG_PLAYERVOICESTOP, *LPDVMSG_PLAYERVOICESTOP, *PDVMSG_PLAYERVOICESTOP; |
|
|
|
// |
|
// Transmission has started on the local machine |
|
// (DVMSGID_RECORDSTART) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
DWORD dwPeakLevel; // Peak level that caused transmission to start |
|
PVOID pvLocalPlayerContext; // Context value for the local player |
|
} DVMSG_RECORDSTART, *LPDVMSG_RECORDSTART, *PDVMSG_RECORDSTART; |
|
|
|
// |
|
// Transmission has stopped on the local machine |
|
// (DVMSGID_RECORDSTOP) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
DWORD dwPeakLevel; // Peak level that caused transmission to stop |
|
PVOID pvLocalPlayerContext; // Context value for the local player |
|
} DVMSG_RECORDSTOP, *LPDVMSG_RECORDSTOP, *PDVMSG_RECORDSTOP; |
|
|
|
// |
|
// The voice session has been lost |
|
// (DVMSGID_SESSIONLOST) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
HRESULT hrResult; // Reason the session was disconnected |
|
} DVMSG_SESSIONLOST, *LPDVMSG_SESSIONLOST, *PDVMSG_SESSIONLOST; |
|
|
|
// |
|
// The target list has been updated for the local client |
|
// (DVMSGID_SETTARGETS) |
|
// |
|
typedef struct |
|
{ |
|
DWORD dwSize; // Size of this structure |
|
DWORD dwNumTargets; // # of targets |
|
PDVID pdvidTargets; // An array of DVIDs specifying the current targets |
|
} DVMSG_SETTARGETS, *LPDVMSG_SETTARGETS, *PDVMSG_SETTARGETS; |
|
|
|
|
|
/**************************************************************************** |
|
* |
|
* DirectPlayVoice Functions |
|
* |
|
****************************************************************************/ |
|
|
|
/* |
|
* |
|
* This function is no longer supported. It is recommended that CoCreateInstance be used to create |
|
* DirectPlay voice objects. |
|
* |
|
* extern HRESULT WINAPI DirectPlayVoiceCreate( const GUID * pcIID, void **ppvInterface, IUnknown *pUnknown); |
|
* |
|
*/ |
|
|
|
/**************************************************************************** |
|
* |
|
* DirectPlay8 Application Interfaces |
|
* |
|
****************************************************************************/ |
|
|
|
#undef INTERFACE |
|
#define INTERFACE IDirectPlayVoiceClient |
|
DECLARE_INTERFACE_( IDirectPlayVoiceClient, IUnknown ) |
|
{ |
|
/*** IUnknown methods ***/ |
|
STDMETHOD(QueryInterface)(THIS_ REFIID riid, PVOID *ppvObj) PURE; |
|
STDMETHOD_(ULONG,AddRef)(THIS) PURE; |
|
STDMETHOD_(ULONG,Release)(THIS) PURE; |
|
/*** IDirectPlayVoiceClient methods ***/ |
|
STDMETHOD_(HRESULT, Initialize) (THIS_ LPUNKNOWN, PDVMESSAGEHANDLER, PVOID, PDWORD, DWORD ) PURE; |
|
STDMETHOD_(HRESULT, Connect) (THIS_ PDVSOUNDDEVICECONFIG, PDVCLIENTCONFIG, DWORD ) PURE; |
|
STDMETHOD_(HRESULT, Disconnect) (THIS_ DWORD ) PURE; |
|
STDMETHOD_(HRESULT, GetSessionDesc)(THIS_ PDVSESSIONDESC ) PURE; |
|
STDMETHOD_(HRESULT, GetClientConfig)(THIS_ PDVCLIENTCONFIG ) PURE; |
|
STDMETHOD_(HRESULT, SetClientConfig)(THIS_ PDVCLIENTCONFIG ) PURE; |
|
STDMETHOD_(HRESULT, GetCaps) (THIS_ PDVCAPS ) PURE; |
|
STDMETHOD_(HRESULT, GetCompressionTypes)( THIS_ PVOID, PDWORD, PDWORD, DWORD ) PURE; |
|
STDMETHOD_(HRESULT, SetTransmitTargets)( THIS_ PDVID, DWORD, DWORD ) PURE; |
|
STDMETHOD_(HRESULT, GetTransmitTargets)( THIS_ PDVID, PDWORD, DWORD ) PURE; |
|
STDMETHOD_(HRESULT, Create3DSoundBuffer)( THIS_ DVID, LPDIRECTSOUNDBUFFER, DWORD, DWORD, LPDIRECTSOUND3DBUFFER * ) PURE; |
|
STDMETHOD_(HRESULT, Delete3DSoundBuffer)( THIS_ DVID, LPDIRECTSOUND3DBUFFER * ) PURE; |
|
STDMETHOD_(HRESULT, SetNotifyMask)( THIS_ PDWORD, DWORD ) PURE; |
|
STDMETHOD_(HRESULT, GetSoundDeviceConfig)( THIS_ PDVSOUNDDEVICECONFIG, PDWORD ) PURE; |
|
}; |
|
|
|
|
|
#undef INTERFACE |
|
#define INTERFACE IDirectPlayVoiceServer |
|
DECLARE_INTERFACE_( IDirectPlayVoiceServer, IUnknown ) |
|
{ |
|
/*** IUnknown methods ***/ |
|
STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE; |
|
STDMETHOD_(ULONG,AddRef) (THIS) PURE; |
|
STDMETHOD_(ULONG,Release) (THIS) PURE; |
|
/*** IDirectPlayVoiceServer methods ***/ |
|
STDMETHOD_(HRESULT, Initialize) (THIS_ LPUNKNOWN, PDVMESSAGEHANDLER, PVOID, LPDWORD, DWORD ) PURE; |
|
STDMETHOD_(HRESULT, StartSession) (THIS_ PDVSESSIONDESC, DWORD ) PURE; |
|
STDMETHOD_(HRESULT, StopSession) (THIS_ DWORD ) PURE; |
|
STDMETHOD_(HRESULT, GetSessionDesc)(THIS_ PDVSESSIONDESC ) PURE; |
|
STDMETHOD_(HRESULT, SetSessionDesc)(THIS_ PDVSESSIONDESC ) PURE; |
|
STDMETHOD_(HRESULT, GetCaps) (THIS_ PDVCAPS ) PURE; |
|
STDMETHOD_(HRESULT, GetCompressionTypes)( THIS_ PVOID, PDWORD, PDWORD, DWORD ) PURE; |
|
STDMETHOD_(HRESULT, SetTransmitTargets)( THIS_ DVID, PDVID, DWORD, DWORD ) PURE; |
|
STDMETHOD_(HRESULT, GetTransmitTargets)( THIS_ DVID, PDVID, PDWORD, DWORD ) PURE; |
|
STDMETHOD_(HRESULT, SetNotifyMask)( THIS_ PDWORD, DWORD ) PURE; |
|
}; |
|
|
|
#undef INTERFACE |
|
#define INTERFACE IDirectPlayVoiceTest |
|
DECLARE_INTERFACE_( IDirectPlayVoiceTest, IUnknown ) |
|
{ |
|
/*** IUnknown methods ***/ |
|
STDMETHOD(QueryInterface) (THIS_ REFIID riid, PVOID * ppvObj) PURE; |
|
STDMETHOD_(ULONG,AddRef) (THIS) PURE; |
|
STDMETHOD_(ULONG,Release) (THIS) PURE; |
|
/*** IDirectPlayVoiceTest methods ***/ |
|
STDMETHOD_(HRESULT, CheckAudioSetup) (THIS_ const GUID *, const GUID * , HWND, DWORD ) PURE; |
|
}; |
|
|
|
#if !defined(__cplusplus) || defined(CINTERFACE) |
|
|
|
#define IDirectPlayVoiceClient_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b) |
|
#define IDirectPlayVoiceClient_AddRef(p) (p)->lpVtbl->AddRef(p) |
|
#define IDirectPlayVoiceClient_Release(p) (p)->lpVtbl->Release(p) |
|
|
|
#define IDirectPlayVoiceClient_Initialize(p,a,b,c,d,e) (p)->lpVtbl->Initialize(p,a,b,c,d,e) |
|
#define IDirectPlayVoiceClient_Connect(p,a,b,c) (p)->lpVtbl->Connect(p,a,b,c) |
|
#define IDirectPlayVoiceClient_Disconnect(p,a) (p)->lpVtbl->Disconnect(p,a) |
|
#define IDirectPlayVoiceClient_GetSessionDesc(p,a) (p)->lpVtbl->GetSessionDesc(p,a) |
|
#define IDirectPlayVoiceClient_GetClientConfig(p,a) (p)->lpVtbl->GetClientConfig(p,a) |
|
#define IDirectPlayVoiceClient_SetClientConfig(p,a) (p)->lpVtbl->SetClientConfig(p,a) |
|
#define IDirectPlayVoiceClient_GetCaps(p,a) (p)->lpVtbl->GetCaps(p,a) |
|
#define IDirectPlayVoiceClient_GetCompressionTypes(p,a,b,c,d) (p)->lpVtbl->GetCompressionTypes(p,a,b,c,d) |
|
#define IDirectPlayVoiceClient_SetTransmitTargets(p,a,b,c) (p)->lpVtbl->SetTransmitTargets(p,a,b,c) |
|
#define IDirectPlayVoiceClient_GetTransmitTargets(p,a,b,c) (p)->lpVtbl->GetTransmitTargets(p,a,b,c) |
|
#define IDirectPlayVoiceClient_Create3DSoundBuffer(p,a,b,c,d,e) (p)->lpVtbl->Create3DSoundBuffer(p,a,b,c,d,e) |
|
#define IDirectPlayVoiceClient_Delete3DSoundBuffer(p,a,b) (p)->lpVtbl->Delete3DSoundBuffer(p,a,b) |
|
#define IDirectPlayVoiceClient_SetNotifyMask(p,a,b) (p)->lpVtbl->SetNotifyMask(p,a,b) |
|
#define IDirectPlayVoiceClient_GetSoundDeviceConfig(p,a,b) (p)->lpVtbl->GetSoundDeviceConfig(p,a,b) |
|
|
|
#define IDirectPlayVoiceServer_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b) |
|
#define IDirectPlayVoiceServer_AddRef(p) (p)->lpVtbl->AddRef(p) |
|
#define IDirectPlayVoiceServer_Release(p) (p)->lpVtbl->Release(p) |
|
|
|
#define IDirectPlayVoiceServer_Initialize(p,a,b,c,d,e) (p)->lpVtbl->Initialize(p,a,b,c,d,e) |
|
#define IDirectPlayVoiceServer_StartSession(p,a,b) (p)->lpVtbl->StartSession(p,a,b) |
|
#define IDirectPlayVoiceServer_StopSession(p,a) (p)->lpVtbl->StopSession(p,a) |
|
#define IDirectPlayVoiceServer_GetSessionDesc(p,a) (p)->lpVtbl->GetSessionDesc(p,a) |
|
#define IDirectPlayVoiceServer_SetSessionDesc(p,a) (p)->lpVtbl->SetSessionDesc(p,a) |
|
#define IDirectPlayVoiceServer_GetCaps(p,a) (p)->lpVtbl->GetCaps(p,a) |
|
#define IDirectPlayVoiceServer_GetCompressionTypes(p,a,b,c,d) (p)->lpVtbl->GetCompressionTypes(p,a,b,c,d) |
|
#define IDirectPlayVoiceServer_SetTransmitTargets(p,a,b,c,d) (p)->lpVtbl->SetTransmitTargets(p,a,b,c,d) |
|
#define IDirectPlayVoiceServer_GetTransmitTargets(p,a,b,c,d) (p)->lpVtbl->GetTransmitTargets(p,a,b,c,d) |
|
#define IDirectPlayVoiceServer_SetNotifyMask(p,a,b) (p)->lpVtbl->SetNotifyMask(p,a,b) |
|
#define IDirectPlayVoiceTest_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b) |
|
#define IDirectPlayVoiceTest_AddRef(p) (p)->lpVtbl->AddRef(p) |
|
#define IDirectPlayVoiceTest_Release(p) (p)->lpVtbl->Release(p) |
|
#define IDirectPlayVoiceTest_CheckAudioSetup(p,a,b,c,d) (p)->lpVtbl->CheckAudioSetup(p,a,b,c,d) |
|
|
|
|
|
#else /* C++ */ |
|
|
|
#define IDirectPlayVoiceClient_QueryInterface(p,a,b) (p)->QueryInterface(a,b) |
|
#define IDirectPlayVoiceClient_AddRef(p) (p)->AddRef() |
|
#define IDirectPlayVoiceClient_Release(p) (p)->Release() |
|
|
|
#define IDirectPlayVoiceClient_Initialize(p,a,b,c,d,e) (p)->Initialize(a,b,c,d,e) |
|
#define IDirectPlayVoiceClient_Connect(p,a,b,c) (p)->Connect(a,b,c) |
|
#define IDirectPlayVoiceClient_Disconnect(p,a) (p)->Disconnect(a) |
|
#define IDirectPlayVoiceClient_GetSessionDesc(p,a) (p)->GetSessionDesc(a) |
|
#define IDirectPlayVoiceClient_GetClientConfig(p,a) (p)->GetClientConfig(a) |
|
#define IDirectPlayVoiceClient_SetClientConfig(p,a) (p)->SetClientConfig(a) |
|
#define IDirectPlayVoiceClient_GetCaps(p,a) (p)->GetCaps(a) |
|
#define IDirectPlayVoiceClient_GetCompressionTypes(p,a,b,c,d) (p)->GetCompressionTypes(a,b,c,d) |
|
#define IDirectPlayVoiceClient_SetTransmitTargets(p,a,b,c) (p)->SetTransmitTargets(a,b,c) |
|
#define IDirectPlayVoiceClient_GetTransmitTargets(p,a,b,c) (p)->GetTransmitTargets(a,b,c) |
|
#define IDirectPlayVoiceClient_Create3DSoundBuffer(p,a,b,c,d,e) (p)->Create3DSoundBuffer(a,b,c,d,e) |
|
#define IDirectPlayVoiceClient_Delete3DSoundBuffer(p,a,b) (p)->Delete3DSoundBuffer(a,b) |
|
#define IDirectPlayVoiceClient_SetNotifyMask(p,a,b) (p)->SetNotifyMask(a,b) |
|
#define IDirectPlayVoiceClient_GetSoundDeviceConfig(p,a,b) (p)->GetSoundDeviceConfig(a,b) |
|
|
|
#define IDirectPlayVoiceServer_QueryInterface(p,a,b) (p)->QueryInterface(a,b) |
|
#define IDirectPlayVoiceServer_AddRef(p) (p)->AddRef() |
|
#define IDirectPlayVoiceServer_Release(p) (p)->Release() |
|
|
|
#define IDirectPlayVoiceServer_Initialize(p,a,b,c,d,e) (p)->Initialize(a,b,c,d,e) |
|
#define IDirectPlayVoiceServer_StartSession(p,a,b) (p)->StartSession(a,b) |
|
#define IDirectPlayVoiceServer_StopSession(p,a) (p)->StopSession(a) |
|
#define IDirectPlayVoiceServer_GetSessionDesc(p,a) (p)->GetSessionDesc(a) |
|
#define IDirectPlayVoiceServer_SetSessionDesc(p,a) (p)->SetSessionDesc(a) |
|
#define IDirectPlayVoiceServer_GetCaps(p,a) (p)->GetCaps(a) |
|
#define IDirectPlayVoiceServer_GetCompressionTypes(p,a,b,c,d) (p)->GetCompressionTypes(a,b,c,d) |
|
#define IDirectPlayVoiceServer_SetTransmitTargets(p,a,b,c,d) (p)->SetTransmitTargets(a,b,c,d) |
|
#define IDirectPlayVoiceServer_GetTransmitTargets(p,a,b,c,d) (p)->GetTransmitTargets(a,b,c,d) |
|
#define IDirectPlayVoiceServer_SetNotifyMask(p,a,b) (p)->SetNotifyMask(a,b) |
|
|
|
#define IDirectPlayVoiceTest_QueryInterface(p,a,b) (p)->QueryInterface(a,b) |
|
#define IDirectPlayVoiceTest_AddRef(p) (p)->AddRef() |
|
#define IDirectPlayVoiceTest_Release(p) (p)->Release() |
|
#define IDirectPlayVoiceTest_CheckAudioSetup(p,a,b,c,d) (p)->CheckAudioSetup(a,b,c,d) |
|
|
|
|
|
#endif |
|
|
|
|
|
/**************************************************************************** |
|
* |
|
* DIRECTPLAYVOICE ERRORS |
|
* |
|
* Errors are represented by negative values and cannot be combined. |
|
* |
|
****************************************************************************/ |
|
|
|
#define _FACDPV 0x15 |
|
#define MAKE_DVHRESULT( code ) MAKE_HRESULT( 1, _FACDPV, code ) |
|
|
|
#define DV_OK S_OK |
|
#define DV_FULLDUPLEX MAKE_HRESULT( 0, _FACDPV, 0x0005 ) |
|
#define DV_HALFDUPLEX MAKE_HRESULT( 0, _FACDPV, 0x000A ) |
|
#define DV_PENDING MAKE_HRESULT( 0, _FACDPV, 0x0010 ) |
|
|
|
#define DVERR_BUFFERTOOSMALL MAKE_DVHRESULT( 0x001E ) |
|
#define DVERR_EXCEPTION MAKE_DVHRESULT( 0x004A ) |
|
#define DVERR_GENERIC E_FAIL |
|
#define DVERR_INVALIDFLAGS MAKE_DVHRESULT( 0x0078 ) |
|
#define DVERR_INVALIDOBJECT MAKE_DVHRESULT( 0x0082 ) |
|
#define DVERR_INVALIDPARAM E_INVALIDARG |
|
#define DVERR_INVALIDPLAYER MAKE_DVHRESULT( 0x0087 ) |
|
#define DVERR_INVALIDGROUP MAKE_DVHRESULT( 0x0091 ) |
|
#define DVERR_INVALIDHANDLE MAKE_DVHRESULT( 0x0096 ) |
|
#define DVERR_OUTOFMEMORY E_OUTOFMEMORY |
|
#define DVERR_PENDING DV_PENDING |
|
#define DVERR_NOTSUPPORTED E_NOTIMPL |
|
#define DVERR_NOINTERFACE E_NOINTERFACE |
|
#define DVERR_SESSIONLOST MAKE_DVHRESULT( 0x012C ) |
|
#define DVERR_NOVOICESESSION MAKE_DVHRESULT( 0x012E ) |
|
#define DVERR_CONNECTIONLOST MAKE_DVHRESULT( 0x0168 ) |
|
#define DVERR_NOTINITIALIZED MAKE_DVHRESULT( 0x0169 ) |
|
#define DVERR_CONNECTED MAKE_DVHRESULT( 0x016A ) |
|
#define DVERR_NOTCONNECTED MAKE_DVHRESULT( 0x016B ) |
|
#define DVERR_CONNECTABORTING MAKE_DVHRESULT( 0x016E ) |
|
#define DVERR_NOTALLOWED MAKE_DVHRESULT( 0x016F ) |
|
#define DVERR_INVALIDTARGET MAKE_DVHRESULT( 0x0170 ) |
|
#define DVERR_TRANSPORTNOTHOST MAKE_DVHRESULT( 0x0171 ) |
|
#define DVERR_COMPRESSIONNOTSUPPORTED MAKE_DVHRESULT( 0x0172 ) |
|
#define DVERR_ALREADYPENDING MAKE_DVHRESULT( 0x0173 ) |
|
#define DVERR_SOUNDINITFAILURE MAKE_DVHRESULT( 0x0174 ) |
|
#define DVERR_TIMEOUT MAKE_DVHRESULT( 0x0175 ) |
|
#define DVERR_CONNECTABORTED MAKE_DVHRESULT( 0x0176 ) |
|
#define DVERR_NO3DSOUND MAKE_DVHRESULT( 0x0177 ) |
|
#define DVERR_ALREADYBUFFERED MAKE_DVHRESULT( 0x0178 ) |
|
#define DVERR_NOTBUFFERED MAKE_DVHRESULT( 0x0179 ) |
|
#define DVERR_HOSTING MAKE_DVHRESULT( 0x017A ) |
|
#define DVERR_NOTHOSTING MAKE_DVHRESULT( 0x017B ) |
|
#define DVERR_INVALIDDEVICE MAKE_DVHRESULT( 0x017C ) |
|
#define DVERR_RECORDSYSTEMERROR MAKE_DVHRESULT( 0x017D ) |
|
#define DVERR_PLAYBACKSYSTEMERROR MAKE_DVHRESULT( 0x017E ) |
|
#define DVERR_SENDERROR MAKE_DVHRESULT( 0x017F ) |
|
#define DVERR_USERCANCEL MAKE_DVHRESULT( 0x0180 ) |
|
#define DVERR_RUNSETUP MAKE_DVHRESULT( 0x0183 ) |
|
#define DVERR_INCOMPATIBLEVERSION MAKE_DVHRESULT( 0x0184 ) |
|
#define DVERR_INITIALIZED MAKE_DVHRESULT( 0x0187 ) |
|
#define DVERR_INVALIDPOINTER E_POINTER |
|
#define DVERR_NOTRANSPORT MAKE_DVHRESULT( 0x0188 ) |
|
#define DVERR_NOCALLBACK MAKE_DVHRESULT( 0x0189 ) |
|
#define DVERR_TRANSPORTNOTINIT MAKE_DVHRESULT( 0x018A ) |
|
#define DVERR_TRANSPORTNOSESSION MAKE_DVHRESULT( 0x018B ) |
|
#define DVERR_TRANSPORTNOPLAYER MAKE_DVHRESULT( 0x018C ) |
|
#define DVERR_USERBACK MAKE_DVHRESULT( 0x018D ) |
|
#define DVERR_NORECVOLAVAILABLE MAKE_DVHRESULT( 0x018E ) |
|
#define DVERR_INVALIDBUFFER MAKE_DVHRESULT( 0x018F ) |
|
#define DVERR_LOCKEDBUFFER MAKE_DVHRESULT( 0x0190 ) |
|
|
|
#ifdef __cplusplus |
|
} |
|
#endif |
|
|
|
#endif |
|
|
|
|
|
|