Home Explore Help
Sign In
chestercs
/
detectSoundlevel-spike
1
0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Branch: master
Branches Tags
detectSoundleve...
/
VA-2.3
/
VA.html

VA.html 34 KB
Permalink History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890 
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
    2. 

  2. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
    3. 

  3.   <head>
    4. 

  4.     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    5. 

  5.     <meta name="Generator" content="XN-Docs v2.03 (http://ccgi.inspiration3.plus.com/ahk/xn-docs/)" />
    6. 

  6.     <title>Vista Audio Control Function Reference</title>
    7. 

  7.     <style type="text/css" media="all">
    8. 

  8. /*<![CDATA[*/
    9. 

  9. html {
    10. 

  10. 	color: #333;
    11. 

  11. 	background: #fff;
    12. 

  12. 	font: .9em Calibri, Arial, Helvetica, sans-serif;
    13. 

  13. }
    14. 

  14. body { margin: 0em;  min-width: 600px; }
    15. 

  15. h1 {
    16. 

  16. 	margin: 0em;
    17. 

  17. 	color: #fff;
    18. 

  18. 	background: #333;
    19. 

  19. 	padding: .2em .5em;
    20. 

  20. 	border-bottom: 1px solid #000;
    21. 

  21. }
    22. 

  22. h1 a {
    23. 

  23. 	color: #fff !important;
    24. 

  24. 	background: inherit;
    25. 

  25. 	text-decoration: none;
    26. 

  26. }
    27. 

  27. h2 { border-bottom: 1px solid #ddd; }
    28. 

  28. h3.command {
    29. 

  29. 	background: #09c;
    30. 

  30. 	padding: .7em;
    31. 

  31. 	color: #fff;
    32. 

  32. 	cursor: help;
    33. 

  33. 	letter-spacing: .1em;
    34. 

  34. 	font: bold 1.2em "Courier New", Courier, monospace;
    35. 

  35. }
    36. 

  36. a { color: #06c; }
    37. 

  37. a:hover { color: #936; }
    38. 

  38. table { font-size: 1em; }
    39. 

  39. p.descr {
    40. 

  40. 	margin: 1.5em;
    41. 

  41. 	line-height: 1.5;
    42. 

  42. }
    43. 

  43. span.sub {
    44. 

  44. 	color: #666;
    45. 

  45. 	background: inherit;
    46. 

  46. }
    47. 

  47. p.descr span.sub:before { content: ">> "; }
    48. 

  48. table.params span.sub {
    49. 

  49. 	font-size: .75em;
    50. 

  50. 	margin-right: .5em;
    51. 

  51. }
    52. 

  52. div#contents {
    53. 

  53. 	width: 200px;
    54. 

  54. 	float: right;
    55. 

  55. 	border-left: 1px dashed #ddd;
    56. 

  56. 	margin-top: 2em;
    57. 

  57. 	overflow: auto;
    58. 

  58. 	padding: 10px;
    59. 

  59. }
    60. 

  60. div#contents div { margin-left: 1em; }
    61. 

  61. div#contents ul {
    62. 

  62. 	list-style: square;
    63. 

  63. 	padding-left: 1em;
    64. 

  64. }
    65. 

  65. div#contents *:first-child { margin-top: 0em; }
    66. 

  66. div#page {
    67. 

  67.   position: relative;
    68. 

  68.   margin-left: 0px;
    69. 

  69.   margin-right: 230px;
    70. 

  70. 	width: auto;
    71. 

  71. }
    72. 

  72. div#page > div:not(:target) { display: none; }
    73. 

  73. div#page > div:target { display: block; }
    74. 

  74. div.method {
    75. 

  75. 	background: #fefefe;
    76. 

  76. 	border: 1px solid #eee;
    77. 

  77. 	margin-bottom: 2em;
    78. 

  78. 	margin-left: 0.5em;
    79. 

  79. 	padding: 1em;
    80. 

  80. }
    81. 

  81. div.method *:first-child { margin-top: 0em; }
    82. 

  82. div#end {
    83. 

  83. 	font-size: .9em;
    84. 

  84. 	margin-top: 1em;
    85. 

  85. 	border-top: 1px solid #000;
    86. 

  86. 	padding: 1em;
    87. 

  87. 	color: #fff;
    88. 

  88. 	background: #666;
    89. 

  89. }
    90. 

  90. div#end a { color: #fff; }
    91. 

  91. span.vers {
    92. 

  92. 	font-size: .6em;
    93. 

  93. 	color: #ccc;
    94. 

  94. 	padding-left: .3em;
    95. 

  95. }
    96. 

  96. table.params {
    97. 

  97. 	font-size: 1em;
    98. 

  98. 	margin-left: 3em;
    99. 

  99. }
    100. 

  100. table.params th {
    101. 

  101. 	text-align: left;
    102. 

  102. 	background: #eee;
    103. 

  103. 	padding: .2em;
    104. 

  104. }
    105. 

  105. table.params td {
    106. 

  106. 	vertical-align: top;
    107. 

  107. 	padding: .2em 1em .2em .5em;
    108. 

  108. 	background: #fff;
    109. 

  109. 	border: 1px solid #f3f3f3;
    110. 

  110. }
    111. 

  111. table.params td:first-child { background: #f3f3f3 !important; }
    112. 

  112. table.params tr.returns td { background: #f3f3f3; }
    113. 

  113. table.params tr.returns td:first-child { background: #fff !important; }
    114. 

  114. table.dataset { margin-left: 3em; }
    115. 

  115. table.dataset th {
    116. 

  116. 	background: #eee;
    117. 

  117. 	text-align: left;
    118. 

  118. 	padding: .2em;
    119. 

  119. }
    120. 

  120. table.dataset td {
    121. 

  121. 	vertical-align: top;
    122. 

  122. 	padding: .2em 1em .2em .5em;
    123. 

  123. }
    124. 

  124. pre.code {
    125. 

  125. 	padding: 1em;
    126. 

  126. 	font-size: 1em;
    127. 

  127. 	border: 1px dotted #999;
    128. 

  128. 	background: #fff;
    129. 

  129. 	margin-left: 2em;
    130. 

  130. 	overflow: auto;
    131. 

  131. }
    132. 

  132. kbd { font: 1em "Courier New", Courier, monospace; }
    133. 

  133. code, pre.code { font: .9em "Courier New", Courier, monospace; }
    134. 

  134. pre.code em, code em {
    135. 

  135. 	color: #060;
    136. 

  136. 	font-style: normal;
    137. 

  137. 	font-weight: bold;
    138. 

  138. }
    139. 

  139. pre.code kbd, code kbd {
    140. 

  140. 	color: #c00;
    141. 

  141. 	font-weight: normal;
    142. 

  142. }
    143. 

  143. pre.code var, code var {
    144. 

  144. 	font-style: normal;
    145. 

  145. 	font-weight: bold;
    146. 

  146. 	color: #f80;
    147. 

  147. }
    148. 

  148. pre.code var.prc, code var.prc {
    149. 

  149. 	font-weight: normal;
    150. 

  150. 	color: #f00;
    151. 

  151. 	font-style: italic;
    152. 

  152. }
    153. 

  153. pre.code strong, code strong { color: #039; }
    154. 

  154. pre.code strong.res, code strong.res { color: #800000; }
    155. 

  155. @media print {
    156. 

  156. 	* {
    157. 

  157. 		background: none !important;
    158. 

  158. 		color: #000 !important;
    159. 

  159. 	}
    160. 

  160. 	p.descr span.sub, div#contents { display: none; }
    161. 

  161. 	div#page { width: 100%; }
    162. 

  162. 	div#page > div:not(:target) { display: block; }
    163. 

  163. 	table.params, pre.code { margin: 0em; }
    164. 

  164. 	div.method {
    165. 

  165. 		border: none;
    166. 

  166. 		margin: 1em 0em;
    167. 

  167. 		padding: 0em;
    168. 

  168. 	}
    169. 

  169. 	pre.code { overflow: visible; }
    170. 

  170. }
    171. 

  171. /*]]>*/
    172. 

  172.     </style>
    173. 

  173.     <script type="text/javascript">
    174. 

  174. /*<![CDATA[*/
    175. 

  175. function tabsetup() {
    176. 

  176. var a = document.getElementById('contents').getElementsByTagName('a'), i;
    177. 

  177. 	tabswitch(window.location.hash);
    178. 

  178. 	for (i in a) { a[i].onclick = tabswitch; }
    179. 

  179. }
    180. 

  180. function tabswitch(e) {
    181. 

  181. 	var d = document.getElementById('page').getElementsByTagName('div'),
    182. 

  182. 		h = typeof(e) == 'string' ? e : this.hash, id = h ? h.slice(1) : '', i;
    183. 

  183. 	for (i = 0; i < d.length; i++) { if (d[i].className == 'method') { d[i].style.display = 'none'; } }
    184. 

  184. 	if (id) { document.getElementById(id).style.display = 'block'; }
    185. 

  185. }
    186. 

  186. if (window.attachEvent) { window.attachEvent('onload', tabsetup); }
    187. 

  187. /*]]>*/
    188. 

  188.     </script>
    189. 

  189.   </head>
    190. 

  190.   <body>
    191. 

  191.     <h1>
    192. 

  192.       <a href="http://www.autohotkey.com/forum/topic23792.html">Vista Audio Control Function Reference</a><span class="vers"> (version 2.3)</span>
    193. 

  193.     </h1>
    194. 

  194.     <div id="contents">
    195. 

  195.       <div>
    196. 

  196.         <h4>Master Controls</h4>
    197. 

  197.         <ul>
    198. 

  198.           <li>
    199. 

  199.             <a href="#VA_GetMasterVolume">VA_GetMasterVolume</a>
    200. 

  200.           </li>
    201. 

  201.           <li>
    202. 

  202.             <a href="#VA_SetMasterVolume">VA_SetMasterVolume</a>
    203. 

  203.           </li>
    204. 

  204.           <li>
    205. 

  205.             <a href="#VA_GetMasterChannelCount">VA_GetMasterChannelCount</a>
    206. 

  206.           </li>
    207. 

  207.           <li>
    208. 

  208.             <a href="#VA_GetMasterMute">VA_GetMasterMute</a>
    209. 

  209.           </li>
    210. 

  210.           <li>
    211. 

  211.             <a href="#VA_SetMasterMute">VA_SetMasterMute</a>
    212. 

  212.           </li>
    213. 

  213.         </ul>
    214. 

  214.         <h4>Subunit Controls</h4>
    215. 

  215.         <ul>
    216. 

  216.           <li>
    217. 

  217.             <a href="#VA_GetVolume">VA_GetVolume</a>
    218. 

  218.           </li>
    219. 

  219.           <li>
    220. 

  220.             <a href="#VA_SetVolume">VA_SetVolume</a>
    221. 

  221.           </li>
    222. 

  222.           <li>
    223. 

  223.             <a href="#VA_GetChannelCount">VA_GetChannelCount</a>
    224. 

  224.           </li>
    225. 

  225.           <li>
    226. 

  226.             <a href="#VA_GetMute">VA_GetMute</a>
    227. 

  227.           </li>
    228. 

  228.           <li>
    229. 

  229.             <a href="#VA_SetMute">VA_SetMute</a>
    230. 

  230.           </li>
    231. 

  231.         </ul>
    232. 

  232.         <h4>Advanced</h4>
    233. 

  233.         <ul>
    234. 

  234.           <li>
    235. 

  235.             <a href="#VA_GetAudioEndpointVolume">VA_GetAudioEndpointVolume</a>
    236. 

  236.           </li>
    237. 

  237.           <li>
    238. 

  238.             <a href="#VA_GetAudioMeter">VA_GetAudioMeter</a>
    239. 

  239.           </li>
    240. 

  240.           <li>
    241. 

  241.             <a href="#VA_GetDevice">VA_GetDevice</a>
    242. 

  242.           </li>
    243. 

  243.           <li>
    244. 

  244.             <a href="#VA_GetDeviceName">VA_GetDeviceName</a>
    245. 

  245.           </li>
    246. 

  246.           <li>
    247. 

  247.             <a href="#VA_GetDevicePeriod">VA_GetDevicePeriod</a>
    248. 

  248.           </li>
    249. 

  249.           <li>
    250. 

  250.             <a href="#VA_GetDeviceSubunit">VA_GetDeviceSubunit</a>
    251. 

  251.           </li>
    252. 

  252.           <li>
    253. 

  253.             <a href="#VA_EnumSubunits">VA_EnumSubunits</a>
    254. 

  254.           </li>
    255. 

  255.           <li>
    256. 

  256.             <a href="#VA_EnumSubunitsEx">VA_EnumSubunitsEx</a>
    257. 

  257.           </li>
    258. 

  258.           <li>
    259. 

  259.             <a href="#VA_FindSubunit">VA_FindSubunit</a>
    260. 

  260.           </li>
    261. 

  261.           <li>
    262. 

  262.             <a href="#VA_SetDefaultEndpoint">VA_SetDefaultEndpoint</a>
    263. 

  263.           </li>
    264. 

  264.           <li>
    265. 

  265.             <a href="#VA_dB2Scalar">VA_dB2Scalar</a>
    266. 

  266.           </li>
    267. 

  267.           <li>
    268. 

  268.             <a href="#VA_Scalar2dB">VA_Scalar2dB</a>
    269. 

  269.           </li>
    270. 

  270.         </ul>
    271. 

  271.         <h4>Other</h4>
    272. 

  272.         <ul>
    273. 

  273.           <li>
    274. 

  274.             <a href="#Interface%20Functions">Interface Functions</a>
    275. 

  275.           </li>
    276. 

  276.         </ul>
    277. 

  277.       </div>
    278. 

  278.     </div>
    279. 

  279.     <p class="descr"><br /><span class="sub">Browse through the topics in the contents list to the right.</span></p>
    280. 

  280.     <div id="page">
    281. 

  281.       <div class="method" id="VA_GetMasterVolume">
    282. 

  282.         <h2>VA_GetMasterVolume</h2>
    283. 

  283.         <p>Gets the master volume level of an audio endpoint device.</p>
    284. 

  284.         <h3 class="command">VA_GetMasterVolume(channel, device_desc)</h3>
    285. 

  285.         <h4>Parameters</h4>
    286. 

  286.         <table class="params">
    287. 

  287.           <tr class="returns">
    288. 

  288.             <td>
    289. 

  289.               <em>Returns</em>
    290. 

  290.             </td>
    291. 

  291.             <td>A value between 0.0 and 100.0, inclusive.</td>
    292. 

  292.           </tr>
    293. 

  293.           <tr>
    294. 

  294.             <td>channel</td>
    295. 

  295.             <td><span class="sub">(optional)</span>The one-based index of the channel to retrieve.</td>
    296. 

  296.           </tr>
    297. 

  297.           <tr>
    298. 

  298.             <td>device_desc</td>
    299. 

  299.             <td><span class="sub">(optional)</span>See <a href="#VA_GetDevice">VA_GetDevice</a>. Defaults to "playback".</td>
    300. 

  300.           </tr>
    301. 

  301.         </table>
    302. 

  302.         <h4>Remarks</h4>
    303. 

  303.         <p>Volume levels returned by this function follow the same curve as the Windows Vista Sound Mixer.</p>
    304. 

  304.         <h4>Example</h4>
    305. 

  305.         <pre class="code"><em>; Get the master volume of the default playback device.</em>
    306. 

  306. volume := <strong>VA_GetMasterVolume</strong>()
    307. 

  307. 

  308. <em>; Get the volume of the first and second channels.</em>
    309. 

  309. volume1 := <strong>VA_GetMasterVolume</strong>(1)
    310. 

  310. volume2 := <strong>VA_GetMasterVolume</strong>(2)
    311. 

  311. 

  312. <em>; Get the master volume of a device by name.</em>
    313. 

  313. lineout_volume := <strong>VA_GetMasterVolume</strong>(<kbd>""</kbd>, <kbd>"Line Out"</kbd>)
    314. 

  314. 

  315. <em>; Get the master volume of the default recording device.</em>
    316. 

  316. recording_volume := <strong>VA_GetMasterVolume</strong>(<kbd>""</kbd>, <kbd>"capture"</kbd>)
    317. 

  317. 

  318. <strong>MsgBox</strong>, % <kbd>"Playback volume:`t"</kbd> volume
    319. 

  319.         . <kbd>"`n  Channel 1:`t"</kbd> volume1
    320. 

  320.         . <kbd>"`n  Channel 2:`t"</kbd> volume2
    321. 

  321.         . <kbd>"`nLine Out volume:`t"</kbd> lineout_volume
    322. 

  322.         . <kbd>"`nRecording volume:`t"</kbd> recording_volume
    323. 

  323.         </pre>
    324. 

  324.       </div>
    325. 

  325.       <div class="method" id="VA_SetMasterVolume">
    326. 

  326.         <h2>VA_SetMasterVolume</h2>
    327. 

  327.         <p>Sets the master volume level of an audio endpoint device.</p>
    328. 

  328.         <h3 class="command">VA_SetMasterVolume(vol, channel, device_desc)</h3>
    329. 

  329.         <h4>Parameters</h4>
    330. 

  330.         <table class="params">
    331. 

  331.           <tr>
    332. 

  332.             <td>vol</td>
    333. 

  333.             <td>A value between 0.0 and 100.0, inclusive.</td>
    334. 

  334.           </tr>
    335. 

  335.           <tr>
    336. 

  336.             <td>channel</td>
    337. 

  337.             <td><span class="sub">(optional)</span>The one-based index of the channel to adjust.</td>
    338. 

  338.           </tr>
    339. 

  339.           <tr>
    340. 

  340.             <td>device_desc</td>
    341. 

  341.             <td><span class="sub">(optional)</span>See <a href="#VA_GetDevice">VA_GetDevice</a>. Defaults to "playback".</td>
    342. 

  342.           </tr>
    343. 

  343.         </table>
    344. 

  344.         <h4>Remarks</h4>
    345. 

  345.         <p>Volume levels set by this function follow the same curve as the Windows Vista Sound Mixer.</p>
    346. 

  346.       </div>
    347. 

  347.       <div class="method" id="VA_GetMasterChannelCount">
    348. 

  348.         <h2>VA_GetMasterChannelCount</h2>
    349. 

  349.         <p>Gets the number of channels an audio endpoint device has.</p>
    350. 

  350.         <h3 class="command">VA_GetMasterChannelCount(device_desc)</h3>
    351. 

  351.         <h4>Parameters</h4>
    352. 

  352.         <table class="params">
    353. 

  353.           <tr>
    354. 

  354.             <td>device_desc</td>
    355. 

  355.             <td><span class="sub">(optional)</span>See <a href="#VA_GetDevice">VA_GetDevice</a>. Defaults to "playback".</td>
    356. 

  356.           </tr>
    357. 

  357.         </table>
    358. 

  358.         <h4>Example</h4>
    359. 

  359.         <pre class="code"><strong>Loop</strong> % <strong>VA_GetMasterChannelCount</strong>()
    360. 

  360.     Message .= <kbd>"Channel "</kbd> <strong class="res">A_Index</strong> <kbd>": "</kbd> <strong>VA_GetMasterVolume</strong>(<strong class="res">A_Index</strong>) <kbd>"`n"</kbd>
    361. 

  361. <strong>MsgBox</strong> %Message%</pre>
    362. 

  362.       </div>
    363. 

  363.       <div class="method" id="VA_GetMasterMute">
    364. 

  364.         <h2>VA_GetMasterMute</h2>
    365. 

  365.         <p>Gets the mute status of an audio endpoint device.</p>
    366. 

  366.         <h3 class="command">VA_GetMasterMute(device_desc)</h3>
    367. 

  367.         <h4>Parameters</h4>
    368. 

  368.         <table class="params">
    369. 

  369.           <tr class="returns">
    370. 

  370.             <td>
    371. 

  371.               <em>Returns</em>
    372. 

  372.             </td>
    373. 

  373.             <td>True if the audio endpoint device is muted, otherwise false.</td>
    374. 

  374.           </tr>
    375. 

  375.           <tr>
    376. 

  376.             <td>device_desc</td>
    377. 

  377.             <td><span class="sub">(optional)</span>See <a href="#VA_GetDevice">VA_GetDevice</a>. Defaults to "playback".</td>
    378. 

  378.           </tr>
    379. 

  379.         </table>
    380. 

  380.       </div>
    381. 

  381.       <div class="method" id="VA_SetMasterMute">
    382. 

  382.         <h2>VA_SetMasterMute</h2>
    383. 

  383.         <p>Mutes or un-mutes an audio endpoint device.</p>
    384. 

  384.         <h3 class="command">VA_SetMasterMute(mute, device_desc)</h3>
    385. 

  385.         <h4>Parameters</h4>
    386. 

  386.         <table class="params">
    387. 

  387.           <tr>
    388. 

  388.             <td>mute</td>
    389. 

  389.             <td>True to mute; false to un-mute.</td>
    390. 

  390.           </tr>
    391. 

  391.           <tr>
    392. 

  392.             <td>device_desc</td>
    393. 

  393.             <td><span class="sub">(optional)</span>See <a href="#VA_GetDevice">VA_GetDevice</a>. Defaults to "playback".</td>
    394. 

  394.           </tr>
    395. 

  395.         </table>
    396. 

  396.       </div>
    397. 

  397.       <div class="method" id="VA_GetVolume">
    398. 

  398.         <h2>VA_GetVolume</h2>
    399. 

  399.         <p>Gets the volume level of a subunit.</p>
    400. 

  400.         <h3 class="command">VA_GetVolume(subunit_desc, channel, device_desc)</h3>
    401. 

  401.         <h4>Parameters</h4>
    402. 

  402.         <table class="params">
    403. 

  403.           <tr class="returns">
    404. 

  404.             <td>
    405. 

  405.               <em>Returns</em>
    406. 

  406.             </td>
    407. 

  407.             <td>A value between 0.0 and 100.0, inclusive.</td>
    408. 

  408.           </tr>
    409. 

  409.           <tr>
    410. 

  410.             <td>subunit_desc</td>
    411. 

  411.             <td><span class="sub">(optional)</span>See <a href="#VA_FindSubunit">VA_FindSubunit</a>. Defaults to "1".</td>
    412. 

  412.           </tr>
    413. 

  413.           <tr>
    414. 

  414.             <td>channel</td>
    415. 

  415.             <td><span class="sub">(optional)</span>The one-based index of the channel to retrieve.</td>
    416. 

  416.           </tr>
    417. 

  417.           <tr>
    418. 

  418.             <td>device_desc</td>
    419. 

  419.             <td><span class="sub">(optional)</span>See <a href="#VA_GetDevice">VA_GetDevice</a>. Defaults to "playback".</td>
    420. 

  420.           </tr>
    421. 

  421.         </table>
    422. 

  422.         <h4>Remarks</h4>
    423. 

  423.         <p>Volume levels returned by this function follow the same curve as the Sound applet in Control Panel, not the Sound Mixer.</p>
    424. 

  424.         <h4>Example</h4>
    425. 

  425.         <pre class="code"><em>; Note that subunit names are audio driver-specific.</em>
    426. 

  426. <em>; The following will match "Line", "Line In", "Line Volume", etc.</em>
    427. 

  427. linein_feedback := <strong>VA_GetVolume</strong>(<kbd>"Line"</kbd>)
    428. 

  428. mic_feedback := <strong>VA_GetVolume</strong>(<kbd>"Mic"</kbd>, <kbd>""</kbd>, <kbd>"Line Out"</kbd>)
    429. 

  429. <strong>MsgBox</strong>, % <kbd>"Line In feedback through default playback device: "</kbd> linein_feedback
    430. 

  430.         . <kbd>"`nMicrophone feedback through Line Out: "</kbd> mic_feedback
    431. 

  431.         . <kbd>"`n(Note: these may be muted.)"</kbd></pre>
    432. 

  432.       </div>
    433. 

  433.       <div class="method" id="VA_SetVolume">
    434. 

  434.         <h2>VA_SetVolume</h2>
    435. 

  435.         <p>Sets the volume level of a subunit.</p>
    436. 

  436.         <h3 class="command">VA_SetVolume(vol, subunit_desc, channel, device_desc)</h3>
    437. 

  437.         <h4>Parameters</h4>
    438. 

  438.         <table class="params">
    439. 

  439.           <tr>
    440. 

  440.             <td>vol</td>
    441. 

  441.             <td>A value between 0.0 and 100.0, inclusive.</td>
    442. 

  442.           </tr>
    443. 

  443.           <tr>
    444. 

  444.             <td>subunit_desc</td>
    445. 

  445.             <td><span class="sub">(optional)</span>See <a href="#VA_FindSubunit">VA_FindSubunit</a>. Defaults to "1".</td>
    446. 

  446.           </tr>
    447. 

  447.           <tr>
    448. 

  448.             <td>channel</td>
    449. 

  449.             <td><span class="sub">(optional)</span>The one-based index of the channel to retrieve.</td>
    450. 

  450.           </tr>
    451. 

  451.           <tr>
    452. 

  452.             <td>device_desc</td>
    453. 

  453.             <td><span class="sub">(optional)</span>See <a href="#VA_GetDevice">VA_GetDevice</a>. Defaults to "playback".</td>
    454. 

  454.           </tr>
    455. 

  455.         </table>
    456. 

  456.         <h4>Remarks</h4>
    457. 

  457.         <p>Volume levels set by this function follow the same curve as the Sound applet in Control Panel, not the Sound Mixer.</p>
    458. 

  458.       </div>
    459. 

  459.       <div class="method" id="VA_GetChannelCount">
    460. 

  460.         <h2>VA_GetChannelCount</h2>
    461. 

  461.         <p>Gets the number of channels a subunit has.</p>
    462. 

  462.         <h3 class="command">VA_GetChannelCount(subunit_desc, device_desc)</h3>
    463. 

  463.         <h4>Parameters</h4>
    464. 

  464.         <table class="params">
    465. 

  465.           <tr>
    466. 

  466.             <td>subunit_desc</td>
    467. 

  467.             <td><span class="sub">(optional)</span>See <a href="#VA_FindSubunit">VA_FindSubunit</a>. Defaults to "1".</td>
    468. 

  468.           </tr>
    469. 

  469.           <tr>
    470. 

  470.             <td>device_desc</td>
    471. 

  471.             <td><span class="sub">(optional)</span>See <a href="#VA_GetDevice">VA_GetDevice</a>. Defaults to "playback".</td>
    472. 

  472.           </tr>
    473. 

  473.         </table>
    474. 

  474.       </div>
    475. 

  475.       <div class="method" id="VA_GetMute">
    476. 

  476.         <h2>VA_GetMute</h2>
    477. 

  477.         <p>Gets the mute status of a subunit.</p>
    478. 

  478.         <h3 class="command">VA_GetMute(subunit_desc, device_desc)</h3>
    479. 

  479.         <h4>Parameters</h4>
    480. 

  480.         <table class="params">
    481. 

  481.           <tr class="returns">
    482. 

  482.             <td>
    483. 

  483.               <em>Returns</em>
    484. 

  484.             </td>
    485. 

  485.             <td>True if the subunit is muted, otherwise false.</td>
    486. 

  486.           </tr>
    487. 

  487.           <tr>
    488. 

  488.             <td>subunit_desc</td>
    489. 

  489.             <td><span class="sub">(optional)</span>See <a href="#VA_FindSubunit">VA_FindSubunit</a>. Defaults to "1".</td>
    490. 

  490.           </tr>
    491. 

  491.           <tr>
    492. 

  492.             <td>device_desc</td>
    493. 

  493.             <td><span class="sub">(optional)</span>See <a href="#VA_GetDevice">VA_GetDevice</a>. Defaults to "playback".</td>
    494. 

  494.           </tr>
    495. 

  495.         </table>
    496. 

  496.       </div>
    497. 

  497.       <div class="method" id="VA_SetMute">
    498. 

  498.         <h2>VA_SetMute</h2>
    499. 

  499.         <p>Mutes or un-mutes a subunit.</p>
    500. 

  500.         <h3 class="command">VA_SetMute(mute, subunit_desc, device_desc)</h3>
    501. 

  501.         <h4>Parameters</h4>
    502. 

  502.         <table class="params">
    503. 

  503.           <tr>
    504. 

  504.             <td>mute</td>
    505. 

  505.             <td>True to mute; false to un-mute.</td>
    506. 

  506.           </tr>
    507. 

  507.           <tr>
    508. 

  508.             <td>subunit_desc</td>
    509. 

  509.             <td><span class="sub">(optional)</span>See <a href="#VA_FindSubunit">VA_FindSubunit</a>. Defaults to "1".</td>
    510. 

  510.           </tr>
    511. 

  511.           <tr>
    512. 

  512.             <td>device_desc</td>
    513. 

  513.             <td><span class="sub">(optional)</span>See <a href="#VA_GetDevice">VA_GetDevice</a>. Defaults to "playback".</td>
    514. 

  514.           </tr>
    515. 

  515.         </table>
    516. 

  516.       </div>
    517. 

  517.       <div class="method" id="VA_GetAudioEndpointVolume">
    518. 

  518.         <h2>VA_GetAudioEndpointVolume</h2>
    519. 

  519.         <p>Gets a pointer to the <a href="http://msdn2.microsoft.com/en-us/library/aa964574(VS.85).aspx">IAudioEndpointVolume</a> interface of an audio endpoint device.</p>
    520. 

  520.         <h3 class="command">VA_GetAudioEndpointVolume(device_desc)</h3>
    521. 

  521.         <h4>Parameters</h4>
    522. 

  522.         <table class="params">
    523. 

  523.           <tr>
    524. 

  524.             <td>device_desc</td>
    525. 

  525.             <td><span class="sub">(optional)</span>See <a href="#VA_GetDevice">VA_GetDevice</a>. Defaults to "playback".</td>
    526. 

  526.           </tr>
    527. 

  527.         </table>
    528. 

  528.         <h4>Remarks</h4>
    529. 

  529.         <p>Use <code><strong>ObjRelease</strong>(pointer)</code> to release the interface pointer when it is no longer needed.</p>
    530. 

  530.       </div>
    531. 

  531.       <div class="method" id="VA_GetAudioMeter">
    532. 

  532.         <h2>VA_GetAudioMeter</h2>
    533. 

  533.         <p>Gets a pointer to the <a href="http://msdn2.microsoft.com/en-us/library/aa964578(VS.85).aspx">IAudioMeterInformation</a> interface of an audio endpoint device.</p>
    534. 

  534.         <h3 class="command">VA_GetAudioMeter(device_desc)</h3>
    535. 

  535.         <h4>Parameters</h4>
    536. 

  536.         <table class="params">
    537. 

  537.           <tr>
    538. 

  538.             <td>device_desc</td>
    539. 

  539.             <td><span class="sub">(optional)</span>See <a href="#VA_GetDevice">VA_GetDevice</a>. Defaults to "playback".</td>
    540. 

  540.           </tr>
    541. 

  541.         </table>
    542. 

  542.         <h4>Remarks</h4>
    543. 

  543.         <p>Use <code><strong>ObjRelease</strong>(pointer)</code> to release the interface pointer when it is no longer needed.</p>
    544. 

  544.         <h4>Example</h4>
    545. 

  545.         <pre class="code"><var class="prc">#SingleInstance</var>, Force
    546. 

  546. MeterLength =<kbd> 30</kbd>
    547. 

  547. 

  548. audioMeter := <strong>VA_GetAudioMeter</strong>()
    549. 

  549. 

  550. <strong>VA_IAudioMeterInformation_GetMeteringChannelCount</strong>(audioMeter, channelCount)
    551. 

  551. 

  552. <em>; "The peak value for each channel is recorded over one device</em>
    553. 

  553. <em>;  period and made available during the subsequent device period."</em>
    554. 

  554. <strong>VA_GetDevicePeriod</strong>(<kbd>"capture"</kbd>, devicePeriod)
    555. 

  555. 

  556. <strong>Loop</strong>
    557. 

  557. {
    558. 

  558.     <em>; Get the peak value across all channels.</em>
    559. 

  559.     <strong>VA_IAudioMeterInformation_GetPeakValue</strong>(audioMeter, peakValue)    
    560. 

  560.     meter := <strong>MakeMeter</strong>(peakValue, MeterLength)
    561. 

  561.     
    562. 

  562.     <em>; Get the peak values of all channels.</em>
    563. 

  563.     <strong>VarSetCapacity</strong>(peakValues, channelCount*4)
    564. 

  564.     <strong>VA_IAudioMeterInformation_GetChannelsPeakValues</strong>(audioMeter, channelCount, &peakValues)
    565. 

  565.     <strong>Loop</strong> %channelCount%
    566. 

  566.         meter .= <kbd>"`n"</kbd> <strong>MakeMeter</strong>(<strong>NumGet</strong>(peakValues, <strong class="res">A_Index</strong>*4-4, <kbd>"float"</kbd>), MeterLength)
    567. 

  567. 

  568.     <strong>ToolTip</strong>, %meter%
    569. 

  569.     <strong>Sleep</strong>, %devicePeriod%
    570. 

  570. }
    571. 

  571. 

  572. <strong>MakeMeter</strong>(fraction, size)
    573. 

  573. {
    574. 

  574.     <strong>global</strong> MeterLength
    575. 

  575.     <strong>Loop</strong> % fraction*size
    576. 

  576.         meter .= <kbd>"|"</kbd>
    577. 

  577.     <strong>Loop</strong> % (1-fraction)*size
    578. 

  578.         meter .= <kbd>"."</kbd>
    579. 

  579.     meter .= <kbd>"  "</kbd> fraction
    580. 

  580.     <strong>return</strong> meter
    581. 

  581. }</pre>
    582. 

  582.       </div>
    583. 

  583.       <div class="method" id="VA_GetDevice">
    584. 

  584.         <h2>VA_GetDevice</h2>
    585. 

  585.         <p>Gets a pointer to the <a href="http://msdn2.microsoft.com/en-us/library/ms679028(VS.85).aspx">IMMDevice</a> interface of an audio endpoint device.</p>
    586. 

  586.         <h3 class="command">VA_GetDevice(device_desc)</h3>
    587. 

  587.         <h4>Parameters</h4>
    588. 

  588.         <table class="params">
    589. 

  589.           <tr>
    590. 

  590.             <td>device_desc</td>
    591. 

  591.             <td>device_id | device_number | ( friendly_name | 'playback' | 'capture' ) [ ':' index ]</td>
    592. 

  592.           </tr>
    593. 

  593.         </table>
    594. 

  594.         <h4>Remarks</h4>
    595. 

  595.         <p>Use <code><strong>ObjRelease</strong>(device)</code> to release the interface pointer when it is no longer needed.</p>
    596. 

  596.         <p>If device_desc is a device pointer returned by a previous call to VA_GetDevice, it is returned as-is.  This behaviour is useful for other functions which accept a device_desc; these functions call VA_GetDevice internally.</p>
    597. 

  597.         <h4>Examples</h4>
    598. 

  598.         <pre class="code">device := <strong>VA_GetDevice</strong>(<kbd>"playback"</kbd>)      <em>; default playback device</em>
    599. 

  599. device := <strong>VA_GetDevice</strong>(<kbd>"playback:1"</kbd>)    <em>; first playback device</em>
    600. 

  600. device := <strong>VA_GetDevice</strong>(<kbd>"nvidia:2"</kbd>)      <em>; second device whose name contains "nvidia"</em>
    601. 

  601. device := <strong>VA_GetDevice</strong>(3)               <em>; third device</em></pre>
    602. 

  602.         <pre class="code"><strong>VA_IMMDevice_GetId</strong>(device, device_id)   <em>; get a device id from a device pointer</em>
    603. 

  603. <em>;...</em>
    604. 

  604. device := <strong>VA_GetDevice</strong>(device_id)       <em>; get a device pointer from an id</em></pre>
    605. 

  605.       </div>
    606. 

  606.       <div class="method" id="VA_GetDeviceName">
    607. 

  607.         <h2>VA_GetDeviceName</h2>
    608. 

  608.         <p>Gets the friendly name of an audio endpoint device.</p>
    609. 

  609.         <h3 class="command">VA_GetDeviceName(device)</h3>
    610. 

  610.         <h4>Parameters</h4>
    611. 

  611.         <table class="params">
    612. 

  612.           <tr>
    613. 

  613.             <td>device</td>
    614. 

  614.             <td>A pointer to an <a href="http://msdn2.microsoft.com/en-us/library/ms679028(VS.85).aspx">IMMDevice</a> interface.</td>
    615. 

  615.           </tr>
    616. 

  616.         </table>
    617. 

  617.       </div>
    618. 

  618.       <div class="method" id="VA_GetDevicePeriod">
    619. 

  619.         <h2>VA_GetDevicePeriod</h2>
    620. 

  620.         <p>Retrieves the length of the periodic interval separating successive processing passes by the audio engine.</p>
    621. 

  621.         <h3 class="command">VA_GetDevicePeriod(device_desc, default_period, minimum_period)</h3>
    622. 

  622.         <h4>Parameters</h4>
    623. 

  623.         <table class="params">
    624. 

  624.           <tr class="returns">
    625. 

  625.             <td>
    626. 

  626.               <em>Returns</em>
    627. 

  627.             </td>
    628. 

  628.             <td>True on success, otherwise false.</td>
    629. 

  629.           </tr>
    630. 

  630.           <tr>
    631. 

  631.             <td>device_desc</td>
    632. 

  632.             <td>See <a href="#VA_GetDevice">VA_GetDevice</a>.</td>
    633. 

  633.           </tr>
    634. 

  634.           <tr>
    635. 

  635.             <td>default_period</td>
    636. 

  636.             <td><span class="sub">(out)</span> The default interval, in milliseconds.</td>
    637. 

  637.           </tr>
    638. 

  638.           <tr>
    639. 

  639.             <td>minimum_period</td>
    640. 

  640.             <td><span class="sub">(out)</span> The minimum interval, in milliseconds.</td>
    641. 

  641.           </tr>
    642. 

  642.         </table>
    643. 

  643.       </div>
    644. 

  644.       <div class="method" id="VA_GetDeviceSubunit">
    645. 

  645.         <h2>VA_GetDeviceSubunit</h2>
    646. 

  646.         <p>Finds a subunit of a device, given a device description.</p>
    647. 

  647.         <h3 class="command">VA_GetDeviceSubunit(device_desc, subunit_desc, subunit_iid)</h3>
    648. 

  648.         <h4>Parameters</h4>
    649. 

  649.         <table class="params">
    650. 

  650.           <tr class="returns">
    651. 

  651.             <td>
    652. 

  652.               <em>Returns</em>
    653. 

  653.             </td>
    654. 

  654.             <td>A pointer to the requested interface of a matching subunit, or 0 if none were found.</td>
    655. 

  655.           </tr>
    656. 

  656.           <tr>
    657. 

  657.             <td>device_desc</td>
    658. 

  658.             <td>See <a href="#VA_GetDevice">VA_GetDevice</a>.</td>
    659. 

  659.           </tr>
    660. 

  660.           <tr>
    661. 

  661.             <td>subunit_desc</td>
    662. 

  662.             <td>See <a href="#VA_FindSubunit">VA_FindSubunit</a> (target_desc).</td>
    663. 

  663.           </tr>
    664. 

  664.           <tr>
    665. 

  665.             <td>subunit_iid</td>
    666. 

  666.             <td>See <a href="#VA_FindSubunit">VA_FindSubunit</a> (target_iid).</td>
    667. 

  667.           </tr>
    668. 

  668.         </table>
    669. 

  669.         <h4>Remarks</h4>
    670. 

  670.         <p>See <a href="#VA_FindSubunit">VA_FindSubunit</a>.</p>
    671. 

  671.       </div>
    672. 

  672.       <div class="method" id="VA_EnumSubunits">
    673. 

  673.         <h2>VA_EnumSubunits</h2>
    674. 

  674.         <p>Enumerates matching subunits of a device.</p>
    675. 

  675.         <h3 class="command">VA_EnumSubunits(device, callback, target_name, target_iid)</h3>
    676. 

  676.         <h4>Parameters</h4>
    677. 

  677.         <table class="params">
    678. 

  678.           <tr class="returns">
    679. 

  679.             <td>
    680. 

  680.               <em>Returns</em>
    681. 

  681.             </td>
    682. 

  682.             <td>See <a href="#VA_EnumSubunitsEx">VA_EnumSubunitsEx</a>.</td>
    683. 

  683.           </tr>
    684. 

  684.           <tr>
    685. 

  685.             <td>device</td>
    686. 

  686.             <td>A pointer to an <a href="http://msdn2.microsoft.com/en-us/library/ms679028(VS.85).aspx">IMMDevice</a> interface.</td>
    687. 

  687.           </tr>
    688. 

  688.           <tr>
    689. 

  689.             <td>callback</td>
    690. 

  690.             <td>A callback accepting two parameters: part, interface.</td>
    691. 

  691.           </tr>
    692. 

  692.           <tr>
    693. 

  693.             <td>target_name</td>
    694. 

  694.             <td><span class="sub">(optional)</span>The full or partial friendly name of a subunit or subunits.</td>
    695. 

  695.           </tr>
    696. 

  696.           <tr>
    697. 

  697.             <td>target_iid</td>
    698. 

  698.             <td><span class="sub">(optional)</span>The ID of an interface which matching subunits must support.</td>
    699. 

  699.           </tr>
    700. 

  700.         </table>
    701. 

  701.         <h4>Remarks</h4>
    702. 

  702.         <p>See <a href="#VA_EnumSubunitsEx">VA_EnumSubunitsEx</a>.</p>
    703. 

  703.       </div>
    704. 

  704.       <div class="method" id="VA_EnumSubunitsEx">
    705. 

  705.         <h2>VA_EnumSubunitsEx</h2>
    706. 

  706.         <p>Enumerates matching subunits of a part (subunit or connector).</p>
    707. 

  707.         <h3 class="command">VA_EnumSubunitsEx(part, data_flow, callback, target_name, target_iid)</h3>
    708. 

  708.         <h4>Parameters</h4>
    709. 

  709.         <table class="params">
    710. 

  710.           <tr class="returns">
    711. 

  711.             <td>
    712. 

  712.               <em>Returns</em>
    713. 

  713.             </td>
    714. 

  714.             <td>See Remarks.</td>
    715. 

  715.           </tr>
    716. 

  716.           <tr>
    717. 

  717.             <td>part</td>
    718. 

  718.             <td>A pointer to an <a href="http://msdn2.microsoft.com/en-us/library/ms679050(VS.85).aspx">IPart</a> interface.</td>
    719. 

  719.           </tr>
    720. 

  720.           <tr>
    721. 

  721.             <td>data_flow</td>
    722. 

  722.             <td>0 to enumerate incoming parts; 1 to enumerate outgoing parts.</td>
    723. 

  723.           </tr>
    724. 

  724.           <tr>
    725. 

  725.             <td>callback</td>
    726. 

  726.             <td>A callback accepting two parameters: part, interface.</td>
    727. 

  727.           </tr>
    728. 

  728.           <tr>
    729. 

  729.             <td>target_name</td>
    730. 

  730.             <td><span class="sub">(optional)</span>The full or partial friendly name of a subunit or subunits.</td>
    731. 

  731.           </tr>
    732. 

  732.           <tr>
    733. 

  733.             <td>target_iid</td>
    734. 

  734.             <td><span class="sub">(optional)</span>The ID of an interface which matching subunits must support.</td>
    735. 

  735.           </tr>
    736. 

  736.         </table>
    737. 

  737.         <h4>Remarks</h4>
    738. 

  738.         <p>The callback is called once for each matching subunit. The callback's first parameter is a pointer to the subunit (<a href="http://msdn2.microsoft.com/en-us/library/ms679050(VS.85).aspx">IPart</a>), while the second        parameter is a pointer to the required interface (or 0 if target_iid was omitted.) If the callback returns a non-zero value, enumeration is        halted and the value is passed on to the caller.</p>
    739. 

  739.       </div>
    740. 

  740.       <div class="method" id="VA_FindSubunit">
    741. 

  741.         <h2>VA_FindSubunit</h2>
    742. 

  742.         <p>Finds a subunit of a device, given a device pointer.</p>
    743. 

  743.         <h3 class="command">VA_FindSubunit(device, target_desc, target_iid)</h3>
    744. 

  744.         <h4>Parameters</h4>
    745. 

  745.         <table class="params">
    746. 

  746.           <tr class="returns">
    747. 

  747.             <td>
    748. 

  748.               <em>Returns</em>
    749. 

  749.             </td>
    750. 

  750.             <td>If a matching subunit is found, the return value is a pointer to the requested interface. Otherwise, the return value is 0.</td>
    751. 

  751.           </tr>
    752. 

  752.           <tr>
    753. 

  753.             <td>device</td>
    754. 

  754.             <td>A pointer to an <a href="http://msdn2.microsoft.com/en-us/library/ms679028(VS.85).aspx">IMMDevice</a> interface.</td>
    755. 

  755.           </tr>
    756. 

  756.           <tr>
    757. 

  757.             <td>target_desc</td>
    758. 

  758.             <td>friendly_name | index | friendly_name:index</td>
    759. 

  759.           </tr>
    760. 

  760.           <tr>
    761. 

  761.             <td>target_iid</td>
    762. 

  762.             <td>An interface ID.</td>
    763. 

  763.           </tr>
    764. 

  764.         </table>
    765. 

  765.         <h4>Remarks</h4>
    766. 

  766.         <p>VA_FindSubunit requires a valid interface identifier. To retrieve a subunit by name alone, use <a href="#VA_EnumSubunits">VA_EnumSubunits</a> or <a href="#VA_EnumSubunitsEx">VA_EnumSubunitsEx</a>.</p>
    767. 

  767.       </div>
    768. 

  768.       <div class="method" id="VA_SetDefaultEndpoint">
    769. 

  769.         <p>Sets the default audio endpoint for a given role.  Requires v2.3 or later.</p>
    770. 

  770.         <h3 class="command">VA_SetDefaultEndpoint(device_desc, role)</h3>
    771. 

  771.         <h4>Parameters</h4>
    772. 

  772.         <table class="params">
    773. 

  773.           <tr class="returns">
    774. 

  774.             <td>
    775. 

  775.               <em>Returns</em>
    776. 

  776.             </td>
    777. 

  777.             <td></td>
    778. 

  778.           </tr>
    779. 

  779.           <tr>
    780. 

  780.             <td>device_desc</td>
    781. 

  781.             <td>See <a href="#VA_GetDevice">VA_GetDevice</a>.</td>
    782. 

  782.           </tr>
    783. 

  783.           <tr>
    784. 

  784.             <td>role</td>
    785. 

  785.             <td>One of the following integer values:<br>
    786. 

  786.             <strong>0</strong>: eConsole - what Windows calls the "Default Device".<br>
    787. 

  787.             <strong>1</strong>: eMultimedia<br>
    788. 

  788.             <strong>2</strong>: eCommunications - what Windows calls the "Default Communication Device".</td>
    789. 

  789.           </tr>
    790. 

  790.         </table>
    791. 

  791.         <h4>Remarks</h4>
    792. 

  792.         <p>This function relies on undocumented interfaces and therefore isn't guaranteed to work.</p>
    793. 

  793.       </div>
    794. 

  794.       <div class="method" id="VA_dB2Scalar">
    795. 

  795.         <h2>VA_dB2Scalar</h2>
    796. 

  796.         <p>Converts a decibel value to a scalar value.</p>
    797. 

  797.         <h3 class="command">VA_dB2Scalar(dB, min_dB, max_dB)</h3>
    798. 

  798.         <h4>Parameters</h4>
    799. 

  799.         <table class="params">
    800. 

  800.           <tr class="returns">
    801. 

  801.             <td>
    802. 

  802.               <em>Returns</em>
    803. 

  803.             </td>
    804. 

  804.             <td>A value between 0.0 and 1.0.</td>
    805. 

  805.           </tr>
    806. 

  806.           <tr>
    807. 

  807.             <td>dB</td>
    808. 

  808.             <td>A decibel value.</td>
    809. 

  809.           </tr>
    810. 

  810.           <tr>
    811. 

  811.             <td>min_dB</td>
    812. 

  812.             <td>Minimum decibel value.</td>
    813. 

  813.           </tr>
    814. 

  814.           <tr>
    815. 

  815.             <td>max_dB</td>
    816. 

  816.             <td>Maximum decibel value.</td>
    817. 

  817.           </tr>
    818. 

  818.         </table>
    819. 

  819.         <h4>Remarks</h4>
    820. 

  820.         <p>The returned scalar value is usually consistent with values reported by the Sound applet in Control Panel, but not values reported by the Sound Mixer.</p>
    821. 

  821.       </div>
    822. 

  822.       <div class="method" id="VA_Scalar2dB">
    823. 

  823.         <h2>VA_Scalar2dB</h2>
    824. 

  824.         <p>Converts a scalar value to a decibel value.</p>
    825. 

  825.         <h3 class="command">VA_Scalar2dB(s, min_dB, max_dB)</h3>
    826. 

  826.         <h4>Parameters</h4>
    827. 

  827.         <table class="params">
    828. 

  828.           <tr class="returns">
    829. 

  829.             <td>
    830. 

  830.               <em>Returns</em>
    831. 

  831.             </td>
    832. 

  832.             <td>A decibel value.</td>
    833. 

  833.           </tr>
    834. 

  834.           <tr>
    835. 

  835.             <td>s</td>
    836. 

  836.             <td>A value between 0.0 and 1.0.</td>
    837. 

  837.           </tr>
    838. 

  838.           <tr>
    839. 

  839.             <td>min_dB</td>
    840. 

  840.             <td>Minimum decibel value.</td>
    841. 

  841.           </tr>
    842. 

  842.           <tr>
    843. 

  843.             <td>max_dB</td>
    844. 

  844.             <td>Maximum decibel value.</td>
    845. 

  845.           </tr>
    846. 

  846.         </table>
    847. 

  847.       </div>
    848. 

  848.       <div class="method" id="Interface Functions">
    849. 

  849.         <h2>Interface Functions</h2>
    850. 

  850.         <p>Functions with the naming pattern "VA_I<em>Interface</em>_<em>Function</em>" are direct equivalents of interface functions. These functions are defined under
    851. 

  851.     INTERFACE WRAPPERS in VA.ahk. For syntax and usage, see <a href="http://msdn2.microsoft.com/en-us/library/ms679156(VS.85).aspx">Core Audio APIs in Windows Vista (Programming Reference)</a>.</p>
    852. 

  852.         <h3 class="command">VA_I<em>Interface</em>_<em>Function</em></h3>
    853. 

  853.         <h4>Remarks</h4>
    854. 

  854.         <p>As of v2.0, interface wrappers for the following interfaces are included:</p>
    855. 

  855.         <ul>
    856. 

  856.           <li><a href="http://msdn.microsoft.com/en-us/library/ms679028">IMMDevice</a></li>
    857. 

  857.           <li><a href="http://msdn.microsoft.com/en-us/library/ms678970">IDeviceTopology</a></li>
    858. 

  858.           <li><a href="http://msdn.microsoft.com/en-us/library/ms678851">IConnector</a></li>
    859. 

  859.           <li><a href="http://msdn.microsoft.com/en-us/library/ms679050">IPart</a></li>
    860. 

  860.           <li><a href="http://msdn.microsoft.com/en-us/library/ms679063">IPartsList</a></li>
    861. 

  861.           <li><a href="http://msdn.microsoft.com/en-us/library/aa964574">IAudioEndpointVolume</a></li>
    862. 

  862.           <li><a href="http://msdn.microsoft.com/en-us/library/ms679067">IPerChannelDbLevel</a> (usable with <a href="http://msdn2.microsoft.com/en-us/library/ms678838(VS.85).aspx">IAudioVolumeLevel</a>)</li>
    863. 

  863.           <li><a href="http://msdn.microsoft.com/en-us/library/ms678773">IAudioMute</a></li>
    864. 

  864.           <li><a href="http://msdn.microsoft.com/en-us/library/ms678718">IAudioAutoGainControl</a></li>
    865. 

  865.           <li><a href="http://msdn.microsoft.com/en-us/library/aa964578">IAudioMeterInformation</a></li>
    866. 

  866.         </ul>
    867. 

  867.         <p>v2.1:</p>
    868. 

  868.         <ul>
    869. 

  869.           <li><a href="http://msdn.microsoft.com/en-us/library/dd370865">IAudioClient</a></li>
    870. 

  870.           <li><a href="http://msdn.microsoft.com/en-us/library/dd368246">IAudioSessionControl</a></li>
    871. 

  871.           <li><a href="http://msdn.microsoft.com/en-us/library/dd370948">IAudioSessionManager</a></li>
    872. 

  872.         </ul>
    873. 

  873.         <p>v2.1 on Windows 7 or later:</p>
    874. 

  874.         <ul>
    875. 

  875.           <li><a href="http://msdn.microsoft.com/en-us/library/dd368248">IAudioSessionControl2</a></li>
    876. 

  876.           <li><a href="http://msdn.microsoft.com/en-us/library/dd370950">IAudioSessionManager2</a></li>
    877. 

  877.           <li><a href="http://msdn.microsoft.com/en-us/library/dd368281">IAudioSessionEnumerator</a></li>
    878. 

  878.         </ul>
    879. 

  879.         <p>v2.2:</p>
    880. 

  880.         <ul>
    881. 

  881.           <li><a href="http://msdn.microsoft.com/en-us/library/dd371399">IMMDeviceEnumerator</a></li>
    882. 

  882.           <li><a href="http://msdn.microsoft.com/en-us/library/dd371396">IMMDeviceCollection</a></li>
    883. 

  883.           <li><a href="http://msdn.microsoft.com/en-us/library/dd371098">IControlInterface</a></li>
    884. 

  884.         </ul>
    885. 

  885.       </div>
    886. 

  886.     </div>
    887. 

  887.     <div style="clear: both;"></div>
    888. 

  888.     <div id="end">Copyright © Lexikos</div>
    889. 

  889.   </body>
    890. 

  890. </html>
    891.