1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
|
/*++ BUILD Version: 0001 // Increment this if a change has global effects
Copyright (c) 1992-1993 Microsoft Corporation
Module Name:
ntddmix.h
Abstract:
This include file defines all constants and types for
accessing a Windows NT sound mixer device.
Author:
Robin Speed (RobinSp) - 14-Sep-1993
Revision History:
--*/
#ifndef _NTDDMIX_
#define _NTDDMIX_
#include <ntddsnd.h> // general sound stuff
#define IOCTL_MIX_BASE 0x0180
//
// Device Name - this string is the name of the device. It is the name
// that when added to the name of the root of the device tree and with
// the device number appended, gives the name of the device required for
// a call to NtOpenFile.
// So for example, if the root is \Device and the Device type is
// MMMix and the device number is 2, the full name is \Device\MMMix2
//
#define DD_MIX_DEVICE_NAME "\\Device\\MMMix"
#define DD_MIX_DEVICE_NAME_U L"\\Device\\MMMix"
//
// Mixer device driver IOCTL set
// No caps call - the caps are dumped to the registry on load which saves
// some code and time.
//
#define IOCTL_MIX_GET_CONFIGURATION CTL_CODE(IOCTL_SOUND_BASE, IOCTL_MIX_BASE + 0x0001, METHOD_BUFFERED, FILE_READ_ACCESS)
#define IOCTL_MIX_GET_CONTROL_DATA CTL_CODE(IOCTL_SOUND_BASE, IOCTL_MIX_BASE + 0x0003, METHOD_BUFFERED, FILE_READ_ACCESS)
#define IOCTL_MIX_GET_LINE_DATA CTL_CODE(IOCTL_SOUND_BASE, IOCTL_MIX_BASE + 0x0004, METHOD_BUFFERED, FILE_READ_ACCESS)
#define IOCTL_MIX_REQUEST_NOTIFY CTL_CODE(IOCTL_SOUND_BASE, IOCTL_MIX_BASE + 0x0005, METHOD_BUFFERED, FILE_READ_ACCESS)
//
// mix structures
//
//
// IOCTL_MIX_GET_LINE_DATA and
// IOCTL_MIX_GET_CONTROL_DATA
//
// Line structure (NB LineID is implicit from location in array)
//
typedef struct {
ULONG Id; // Either Line or control ID
} MIXER_DD_READ_DATA, *PMIXER_DD_READ_DATA;
//
// Variable line data
//
typedef struct {
ULONG fdwLine;
} MIXER_DD_LINE_DATA;
typedef struct {
UCHAR Destination; // Destination
UCHAR Source; // Source (relative to destination)
UCHAR cChannels;
UCHAR cConnections; // Redundant
UCHAR cControls; // NB - redundant - could be deduced
// from the control set.
ULONG dwUser; // settable?
SHORT ShortNameStringId;
SHORT LongNameStringId;
ULONG dwComponentType; // SRC and DEST types
//
// Target information
//
USHORT Type;
USHORT wPid; // No USHORT !!!
SHORT PnameStringId; // Target product name
} MIXER_DD_LINE_CONFIGURATION_DATA, *PMIXER_DD_LINE_CONFIGURATION_DATA;
//
// Control structure (NB Control ID is implicit from location in array)
//
typedef struct {
ULONG dwControlType;
ULONG fdwControl;
UCHAR LineID;
UCHAR cMultipleItems;
SHORT ShortNameStringId;
SHORT LongNameStringId;
union
{
struct
{
LONG lMinimum; // signed minimum for this control
LONG lMaximum; // signed maximum for this control
};
struct
{
ULONG dwMinimum; // unsigned minimum for this control
ULONG dwMaximum; // unsigned maximum for this control
};
ULONG dwReserved[6];
} Bounds;
union
{
ULONG cSteps; // # of steps between min & max
ULONG cbCustomData; // size in bytes of custom data
ULONG dwReserved[6]; // !!! needed? we have cbStruct....
} Metrics;
ULONG TextDataOffset; // Offset to strings if any (or 0)
// Each string is indexed by a string id.
} MIXER_DD_CONTROL_CONFIGURATION_DATA, *PMIXER_DD_CONTROL_CONFIGURATION_DATA;
typedef struct {
ULONG dwParam1;
ULONG dwParam2;
SHORT SubControlTextStringId;
USHORT ControlId; // Debug cross reference.
} MIXER_DD_CONTROL_LISTTEXT, *PMIXER_DD_CONTROL_LISTTEXT;
//
// Capabilities data (using string id)
//
typedef struct {
USHORT wMid; // manufacturer id
USHORT wPid; // product id
MMVERSION vDriverVersion; // version of the driver
ULONG PnameStringId; // product name
ULONG fdwSupport; // misc. support bits
ULONG cDestinations; // count of destinations
} MIXER_DD_CAPS;
//
// The data dumped into the registry.
// The two counts are followed immediately by the appropriate number of
//
// MIXER_DD_LINE_CONFIGURATION_DATA and
//
// MIXER_DD_CONTROL_CONFIGURATION_DATA structures
//
// Next is the set of
//
// MIXER_DD_CONTROL_LISTTEXT structures ordered by control id.
//
// The MIXER_DD_LINE_CONFIGURATION_DATA structures must be ordered
// dest lines first (ie the destination lines have the lowest ids).
// The source lines must be ordered so that their destination lines
// either increase and stay the same - ie the sources for the first
// destination are first etc etc.
//
typedef struct {
ULONG cbSize; // Total size including this field
MIXER_DD_CAPS DeviceCaps; // Mixer device capabilities
ULONG NumberOfLines;
ULONG NumberOfControls;
} MIXER_DD_CONFIGURATION_DATA, *PMIXER_DD_CONFIGURATION_DATA;
//
//
// IOCTL_MIX_REQUEST_NOTIFY - use same data for input and output
// This request will continue to be completed until either
// SetCurrentLogicalTime is set or
//
// CurrentLogicalTime = Logical time of last change to mixer
// controls or lines.
//
// It will next be completed either when the device is closed or the
// next change is made to a control or line.
//
typedef struct {
LARGE_INTEGER CurrentLogicalTime; // Used by driver
BOOLEAN Initialized; // Set to 0 on first use
USHORT Message; // What sort of thing changed?
USHORT Id; // Id of thing that changed
} MIXER_DD_REQUEST_NOTIFY, *PMIXER_DD_REQUEST_NOTIFY;
//
// Data returned by IOCTL_MIX_GET_CAPABILITIES is MIXCAPSW structure
// defined in mmsystem.h
//
#endif // _NTDDMIX_
|
