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
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
|
/*++
Copyright (c) Microsoft Corporation All Rights Reserved
Module Name:
bthhfpmictopotable.h
Abstract:
Declaration of topology table for the Bluetooth hands-free profile mic (external)
--*/
#ifndef _SYSVAD_BTHHFPMICTOPTABLE_H_
#define _SYSVAD_BTHHFPMICTOPTABLE_H_
#include "bthhfpmictopo.h"
//=============================================================================
static
KSDATARANGE BthHfpMicTopoPinDataRangesBridge[] =
{
{
sizeof(KSDATARANGE),
0,
0,
0,
STATICGUIDOF(KSDATAFORMAT_TYPE_AUDIO),
STATICGUIDOF(KSDATAFORMAT_SUBTYPE_ANALOG),
STATICGUIDOF(KSDATAFORMAT_SPECIFIER_NONE)
}
};
//=============================================================================
static
PKSDATARANGE BthHfpMicTopoPinDataRangePointersBridge[] =
{
&BthHfpMicTopoPinDataRangesBridge[0]
};
//=============================================================================
static
PCPIN_DESCRIPTOR BthHfpMicTopoMiniportPins[] =
{
// KSPIN_TOPO_MIC_ELEMENTS
{
0,
0,
0, // InstanceCount
NULL, // AutomationTable
{ // KsPinDescriptor
0, // InterfacesCount
NULL, // Interfaces
0, // MediumsCount
NULL, // Mediums
SIZEOF_ARRAY(BthHfpMicTopoPinDataRangePointersBridge),// DataRangesCount
BthHfpMicTopoPinDataRangePointersBridge, // DataRanges
KSPIN_DATAFLOW_IN, // DataFlow
KSPIN_COMMUNICATION_NONE, // Communication
&KSNODETYPE_HEADSET_MICROPHONE, // Category
NULL, // Name
0 // Reserved
}
},
// KSPIN_TOPO_BRIDGE
{
0,
0,
0, // InstanceCount
NULL, // AutomationTable
{ // KsPinDescriptor
0, // InterfacesCount
NULL, // Interfaces
0, // MediumsCount
NULL, // Mediums
SIZEOF_ARRAY(BthHfpMicTopoPinDataRangePointersBridge),// DataRangesCount
BthHfpMicTopoPinDataRangePointersBridge, // DataRanges
KSPIN_DATAFLOW_OUT, // DataFlow
KSPIN_COMMUNICATION_NONE, // Communication
&KSCATEGORY_AUDIO, // Category
NULL, // Name
0 // Reserved
}
}
};
//=============================================================================
static
KSJACK_DESCRIPTION BthHfpMicJackDesc =
{
KSAUDIO_SPEAKER_MONO,
0, // color
eConnTypeOtherDigital,
eGeoLocNotApplicable,
eGenLocOther,
ePortConnUnknown,
FALSE // run-time code sets this value.
};
// Only return a KSJACK_DESCRIPTION for the physical bridge pin.
static
PKSJACK_DESCRIPTION BthHfpMicJackDescriptions[] =
{
&BthHfpMicJackDesc,
NULL
};
//=============================================================================
static
PCPROPERTY_ITEM BthHfpMicPropertiesVolume[] =
{
{
&KSPROPSETID_Audio,
KSPROPERTY_AUDIO_VOLUMELEVEL,
KSPROPERTY_TYPE_GET | KSPROPERTY_TYPE_SET | KSPROPERTY_TYPE_BASICSUPPORT,
PropertyHandler_BthHfpMicTopoNode
}
};
static
PCEVENT_ITEM BthHfpMicPropertiesVolumeEvent[] =
{
// This is a generic event for nearly every node property.
{
&KSEVENTSETID_AudioControlChange, // Something changed!
KSEVENT_CONTROL_CHANGE, // The only event-property defined.
KSEVENT_TYPE_ENABLE | KSEVENT_TYPE_BASICSUPPORT,
PropertyHandler_BthHfpMicTopoNodeEvent
}
};
DEFINE_PCAUTOMATION_TABLE_PROP_EVENT(AutomationBthHfpMicVolumeWithEvent,
BthHfpMicPropertiesVolume,
BthHfpMicPropertiesVolumeEvent);
//=============================================================================
static
PCPROPERTY_ITEM BthHfpMicPropertiesMute[] =
{
{
&KSPROPSETID_Audio,
KSPROPERTY_AUDIO_MUTE,
KSPROPERTY_TYPE_GET | KSPROPERTY_TYPE_SET | KSPROPERTY_TYPE_BASICSUPPORT,
PropertyHandler_Topology
}
};
DEFINE_PCAUTOMATION_TABLE_PROP(AutomationBthHfpMicMute, BthHfpMicPropertiesMute);
//=============================================================================
// The volume node should be implemented as follows:
//
// #1 If the Bluetooth headset supports volume control, then the audio driver should
// include a volume node in its KS topology. The audio driver's volume property
// handlers send the above IOCLTs to the Bluetooth HFP driver to handle the volume.
//
// #2 If the Bluetooth headset does not implement a hardware volume, and the codec
// (or DSP) has a hardware volume, the audio driver should handle the volume control
// on the codec (or DSP).
//
// #3 If the Bluetooth headset and the audio device do not have hardware volume controls,
// no volume node should be presented and Windows will insert a software volume
// control node.
//
// This sample assumes #1 or #2, and it adds a valume node in its topology.
//
// The mute node is opitional. The driver shall implement the mute node if and only if
// the DSP or audio codec provides the capability to mute the bypass PCM signal before
// passing it to the Bluetooth controller. The mute nodes support
// KSPROPSETID_Audio/KSPROPERTY_AUDIO_MUTE
//
static
PCNODE_DESCRIPTOR BthHfpMicTopologyNodes[] =
{
// KSNODE_TOPO_VOLUME
{
0, // Flags
&AutomationBthHfpMicVolumeWithEvent, // AutomationTable
&KSNODETYPE_VOLUME, // Type
&KSAUDFNAME_MIC_VOLUME // Name
},
// KSNODE_TOPO_MUTE
{
0, // Flags
&AutomationBthHfpMicMute, // AutomationTable
&KSNODETYPE_MUTE, // Type
&KSAUDFNAME_MIC_MUTE // Name
},
};
C_ASSERT( KSNODE_TOPO_VOLUME == 0 );
C_ASSERT( KSNODE_TOPO_MUTE == 1 );
//=============================================================================
static
PCCONNECTION_DESCRIPTOR BthHfpMicMiniportConnections[] =
{
// FromNode, FromPin, ToNode, ToPin
{ PCFILTER_NODE, KSPIN_TOPO_MIC_ELEMENTS, KSNODE_TOPO_VOLUME, 1 },
{ KSNODE_TOPO_VOLUME, 0, KSNODE_TOPO_MUTE, 1 },
{ KSNODE_TOPO_MUTE, 0, PCFILTER_NODE, KSPIN_TOPO_BRIDGE }
};
//=============================================================================
static
PCPROPERTY_ITEM BthHfpMicPropertiesTopoFilter[] =
{
{
&KSPROPSETID_Jack,
KSPROPERTY_JACK_DESCRIPTION,
KSPROPERTY_TYPE_GET | KSPROPERTY_TYPE_BASICSUPPORT,
PropertyHandler_BthHfpMicTopoFilter
},
{
&KSPROPSETID_Jack,
KSPROPERTY_JACK_DESCRIPTION2,
KSPROPERTY_TYPE_GET | KSPROPERTY_TYPE_BASICSUPPORT,
PropertyHandler_BthHfpMicTopoFilter
},
{
&KSPROPSETID_Jack,
KSPROPERTY_JACK_CONTAINERID,
KSPROPERTY_TYPE_GET | KSPROPERTY_TYPE_BASICSUPPORT,
PropertyHandler_BthHfpMicTopoFilter
},
{
&KSPROPSETID_BtAudio,
KSPROPERTY_ONESHOT_RECONNECT,
KSPROPERTY_TYPE_GET | KSPROPERTY_TYPE_BASICSUPPORT,
PropertyHandler_BthHfpMicTopoFilter
},
{
&KSPROPSETID_BtAudio,
KSPROPERTY_ONESHOT_DISCONNECT,
KSPROPERTY_TYPE_GET | KSPROPERTY_TYPE_BASICSUPPORT,
PropertyHandler_BthHfpMicTopoFilter
}
};
static
PCEVENT_ITEM BthHfpMicTopoPropertiesFilterEvent[] =
{
{
&KSEVENTSETID_PinCapsChange, // Something changed!
KSEVENT_PINCAPS_JACKINFOCHANGE, // The only event-property defined.
KSEVENT_TYPE_ENABLE | KSEVENT_TYPE_BASICSUPPORT,
PropertyHandler_BthHfpMicTopoFilterEvent
}
};
DEFINE_PCAUTOMATION_TABLE_PROP_EVENT(AutomationBthHfpMicTopoFilterWithEvent,
BthHfpMicPropertiesTopoFilter,
BthHfpMicTopoPropertiesFilterEvent);
//=============================================================================
static
PCFILTER_DESCRIPTOR BthHfpMicTopoMiniportFilterDescriptor =
{
0, // Version
&AutomationBthHfpMicTopoFilterWithEvent, // AutomationTable
sizeof(PCPIN_DESCRIPTOR), // PinSize
SIZEOF_ARRAY(BthHfpMicTopoMiniportPins), // PinCount
BthHfpMicTopoMiniportPins, // Pins
sizeof(PCNODE_DESCRIPTOR), // NodeSize
SIZEOF_ARRAY(BthHfpMicTopologyNodes), // NodeCount
BthHfpMicTopologyNodes, // Nodes
SIZEOF_ARRAY(BthHfpMicMiniportConnections),// ConnectionCount
BthHfpMicMiniportConnections, // Connections
0, // CategoryCount
NULL // Categories
};
#endif // _SYSVAD_BTHHFPMICTOPTABLE_H_
|
