开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > MacOS编程 > 查看源码
dispaud.c
资源名称：USBView.rar　[点击查看]
上传用户：gzccxsp
上传日期：2015-07-14
资源大小：182k
文件大小：33k
源码类别：

MacOS编程

开发平台：

Visual C++

dispaud.c：源码内容
  1. /*++
  3. Copyright (c) 1997-1998 Microsoft Corporation
  5. Module Name:
  7. DISPAUD.C
  9. Abstract:
  11. This source file contains routines which update the edit control
  12. to display information about USB Audio descriptors.
  14. Environment:
  16. user mode
  18. Revision History:
  20. 03-07-1998 : created
  22. --*/
  24. //*****************************************************************************
  25. // I N C L U D E S
  26. //*****************************************************************************
  28. #include <windows.h>
  29. #include <basetyps.h>
  31. #include "usbview.h"
  33. //*****************************************************************************
  34. // D E F I N E S
  35. //*****************************************************************************
  37. //*****************************************************************************
  38. // T Y P E D E F S
  39. //*****************************************************************************
  41. typedef struct _TERMTYPE
  42. {
  43.     USHORT TermTypeCode;
  44.     PCHAR  TermTypeName;
  45. } TERMTYPE, *PTERMTYPE;
  47. typedef struct _FORMATTYPE
  48. {
  49.     USHORT FormatTypeCode;
  50.     PCHAR  FormatTypeName;
  51. } FORMATTYPE, *PFORMATTYPE;
  53. //*****************************************************************************
  54. // G L O B A L S    P R I V A T E    T O    T H I S    F I L E
  55. //*****************************************************************************
  57. //
  58. // USB Device Class Definition for Terminal Types  0.9 Draft Revision
  59. //
  60. TERMTYPE TermTypes[] =
  61. {
  62.     //
  63.     // 2.1 USB Terminal Types
  64.     //
  65.     {0x0100, "USB Undefined"},
  66.     {0x0101, "USB streaming"},
  67.     {0x01FF, "USB vendor specific"},
  68.     //
  69.     // 2.2 Input Terminal Types
  70.     //
  71.     {0x0200, "Input Undefined"},
  72.     {0x0201, "Microphone"},
  73.     {0x0202, "Desktop microphone"},
  74.     {0x0203, "Personal microphone"},
  75.     {0x0204, "Omni-directional microphone"},
  76.     {0x0205, "Microphone array"},
  77.     {0x0206, "Processing microphone array"},
  78.     //
  79.     // 2.3 Output Terminal Types
  80.     //
  81.     {0x0300, "Output Undefined"},
  82.     {0x0301, "Speaker"},
  83.     {0x0302, "Headphones"},
  84.     {0x0303, "Head Mounted Display Audio"},
  85.     {0x0304, "Desktop speaker"},
  86.     {0x0305, "Room speaker"},
  87.     {0x0306, "Communication speaker"},
  88.     {0x0307, "Low frequency effects speaker"},
  89.     //
  90.     // 2.4 Bi-directional Terminal Types
  91.     //
  92.     {0x0400, "Bi-directional Undefined"},
  93.     {0x0401, "Handset"},
  94.     {0x0402, "Headset"},
  95.     {0x0403, "Speakerphone, no echo reduction"},
  96.     {0x0404, "Echo-suppressing speakerphone"},
  97.     {0x0405, "Echo-canceling speakerphone"},
  98.     //
  99.     // 2.5 Telephony Terminal Types
  100.     //
  101.     {0x0500, "Telephony Undefined"},
  102.     {0x0501, "Phone line"},
  103.     {0x0502, "Telephone"},
  104.     {0x0503, "Down Line Phone"},
  105.     //
  106.     // 2.6 External Terminal Types
  107.     //
  108.     {0x0600, "External Undefined"},
  109.     {0x0601, "Analog connector"},
  110.     {0x0602, "Digital audio interface"},
  111.     {0x0603, "Line connector"},
  112.     {0x0604, "Legacy audio connector"},
  113.     {0x0605, "S/PDIF interface"},
  114.     {0x0606, "1394 DA stream"},
  115.     {0x0607, "1394 DV stream soundtrack"},
  116.     //
  117.     // Embedded Function Terminal Types
  118.     //
  119.     {0x0700, "Embedded Undefined"},
  120.     {0x0701, "Level Calibration Noise Source"},
  121.     {0x0702, "Equalization Noise"},
  122.     {0x0703, "CD player"},
  123.     {0x0704, "DAT"},
  124.     {0x0705, "DCC"},
  125.     {0x0706, "MiniDisk"},
  126.     {0x0707, "Analog Tape"},
  127.     {0x0708, "Phonograph"},
  128.     {0x0709, "VCR Audio"},
  129.     {0x070A, "Video Disc Audio"},
  130.     {0x070B, "DVD Audio"},
  131.     {0x070C, "TV Tuner Audio"},
  132.     {0x070D, "Satellite Receiver Audio"},
  133.     {0x070E, "Cable Tuner Audio"},
  134.     {0x070F, "DSS Audio"},
  135.     {0x0710, "Radio Receiver"},
  136.     {0x0711, "Radio Transmitter"},
  137.     {0x0712, "Multi-track Recorder"},
  138.     {0x0713, "Synthesizer"},
  139.     //
  140.     // Terminate List
  141.     //
  142.     {0xFFFF, NULL}
  143. };
  145. //
  146. // USB Device Class Definition for Audio Data Formats  0.9 Draft Revision
  147. //
  148. FORMATTYPE FormatTypes[] =
  149. {
  150.     //
  151.     // A.1.1 Audio Data Format Type I Codes
  152.     //
  153.     {0x0000, "TYPE_I_UNDEFINED"},
  154.     {0x0001, "PCM"},
  155.     {0x0002, "PCM8"},
  156.     {0x0003, "IEEE_FLOAT"},
  157.     {0x0004, "ALAW"},
  158.     {0x0005, "MULAW"},
  159.     //
  160.     // A.1.2 Audio Data Format Type II Codes
  161.     //
  162.     {0x1000, "TYPE_II_UNDEFINED"},
  163.     {0x1001, "MPEG"},
  164.     {0x1002, "AC-3"},
  165.     //
  166.     // A.1.3 Audio Data Format Type III Codes
  167.     //
  168.     {0x2000, "TYPE_III_UNDEFINED"},
  169.     {0x2001, "IEC1937_AC-3"},
  170.     {0x2002, "IEC1937_MPEG-1_Layer1"},
  171.     {0x2003, "IEC1937_MPEG-1_Layer2/3 or IEC1937_MPEG-2_NOEXT"},
  172.     {0x2004, "IEC1937_MPEG-2_EXT"},
  173.     {0x2005, "IEC1937_MPEG-2_Layer1_LS"},
  174.     {0x2006, "IEC1937_MPEG-2_Layer2/3_LS"},
  175.     //
  176.     // Terminate List
  177.     //
  178.     {0xFFFF, NULL}
  179. };
  181. //*****************************************************************************
  182. // L O C A L    F U N C T I O N    P R O T O T Y P E S
  183. //*****************************************************************************
  185. BOOL
  186. DisplayACHeader (
  187.     PUSB_AUDIO_AC_INTERFACE_HEADER_DESCRIPTOR HeaderDesc
  188. );
  190. BOOL
  191. DisplayACInputTerminal (
  192.     PUSB_AUDIO_INPUT_TERMINAL_DESCRIPTOR ITDesc
  193. );
  195. BOOL
  196. DisplayACOutputTerminal (
  197.     PUSB_AUDIO_OUTPUT_TERMINAL_DESCRIPTOR OTDesc
  198. );
  200. BOOL
  201. DisplayACMixerUnit (
  202.     PUSB_AUDIO_MIXER_UNIT_DESCRIPTOR MixerDesc
  203. );
  205. BOOL
  206. DisplayACSelectorUnit (
  207.     PUSB_AUDIO_SELECTOR_UNIT_DESCRIPTOR SelectorDesc
  208. );
  210. BOOL
  211. DisplayACFeatureUnit (
  212.     PUSB_AUDIO_FEATURE_UNIT_DESCRIPTOR FeatureDesc
  213. );
  215. BOOL
  216. DisplayACProcessingUnit (
  217.     PUSB_AUDIO_PROCESSING_UNIT_DESCRIPTOR ProcessingDesc
  218. );
  220. BOOL
  221. DisplayACExtensionUnit (
  222.     PUSB_AUDIO_EXTENSION_UNIT_DESCRIPTOR ExtensionDesc
  223. );
  225. BOOL
  226. DisplayASGeneral (
  227.     PUSB_AUDIO_GENERAL_DESCRIPTOR GeneralDesc
  228. );
  230. BOOL
  231. DisplayCSEndpoint (
  232.     PUSB_AUDIO_ENDPOINT_DESCRIPTOR EndpointDesc
  233. );
  235. BOOL
  236. DisplayASFormatType (
  237.     PUSB_AUDIO_COMMON_FORMAT_DESCRIPTOR FormatDesc
  238. );
  240. BOOL
  241. DisplayASFormatSpecific (
  242.     PUSB_AUDIO_COMMON_DESCRIPTOR CommonDesc
  243. );
  245. VOID
  246. DisplayBytes (
  247.     PUCHAR Data,
  248.     USHORT Len
  249. );
  251. PCHAR
  252. TermTypeCodeToName (
  253.     USHORT TermTypeCode
  254. );
  256. PCHAR
  257. FormatTypeCodeToName (
  258.     USHORT FormatTypeCode
  259. );
  262. //*****************************************************************************
  263. // L O C A L    F U N C T I O N S
  264. //*****************************************************************************
  268. //*****************************************************************************
  269. //
  270. // DisplayAudioDescriptor()
  271. //
  272. // CommonDesc - An Audio Class Descriptor
  273. //
  274. // bInterfaceSubClass - The SubClass of the Interface containing the descriptor
  275. //
  276. //*****************************************************************************
  278. BOOL
  279. DisplayAudioDescriptor (
  280.     PUSB_AUDIO_COMMON_DESCRIPTOR CommonDesc,
  281.     UCHAR                        bInterfaceSubClass
  282. )
  283. {
  284.     switch (CommonDesc->bDescriptorType)
  285.     {
  286.         case USB_AUDIO_CS_INTERFACE:
  287.             switch (bInterfaceSubClass)
  288.             {
  289.                 case USB_AUDIO_SUBCLASS_AUDIOCONTROL:
  290.                     switch (CommonDesc->bDescriptorSubtype)
  291.                     {
  292.                         case USB_AUDIO_AC_HEADER:
  293.                             return DisplayACHeader((PUSB_AUDIO_AC_INTERFACE_HEADER_DESCRIPTOR)CommonDesc);
  295.                         case USB_AUDIO_AC_INPUT_TERMINAL:
  296.                             return DisplayACInputTerminal((PUSB_AUDIO_INPUT_TERMINAL_DESCRIPTOR)CommonDesc);
  298.                         case USB_AUDIO_AC_OUTPUT_TERMINAL:
  299.                             return DisplayACOutputTerminal((PUSB_AUDIO_OUTPUT_TERMINAL_DESCRIPTOR)CommonDesc);
  301.                         case USB_AUDIO_AC_MIXER_UNIT:
  302.                             return DisplayACMixerUnit((PUSB_AUDIO_MIXER_UNIT_DESCRIPTOR)CommonDesc);
  304.                         case USB_AUDIO_AC_SELECTOR_UNIT:
  305.                             return DisplayACSelectorUnit((PUSB_AUDIO_SELECTOR_UNIT_DESCRIPTOR)CommonDesc);
  307.                         case USB_AUDIO_AC_FEATURE_UNIT:
  308.                             return DisplayACFeatureUnit((PUSB_AUDIO_FEATURE_UNIT_DESCRIPTOR)CommonDesc);
  310.                         case USB_AUDIO_AC_PROCESSING_UNIT:
  311.                             return DisplayACProcessingUnit((PUSB_AUDIO_PROCESSING_UNIT_DESCRIPTOR)CommonDesc);
  313.                         case USB_AUDIO_AC_EXTENSION_UNIT:
  314.                             return DisplayACExtensionUnit((PUSB_AUDIO_EXTENSION_UNIT_DESCRIPTOR)CommonDesc);
  316.                         default:
  317.                             break;
  318.                     }
  319.                     break;
  321.                 case USB_AUDIO_SUBCLASS_AUDIOSTREAMING:
  322.                     switch (CommonDesc->bDescriptorSubtype)
  323.                     {
  324.                         case USB_AUDIO_AS_GENERAL:
  325.                             return DisplayASGeneral((PUSB_AUDIO_GENERAL_DESCRIPTOR)CommonDesc);
  327.                         case USB_AUDIO_AS_FORMAT_TYPE:
  328.                             return DisplayASFormatType((PUSB_AUDIO_COMMON_FORMAT_DESCRIPTOR)CommonDesc);
  329.                             break;
  331.                         case USB_AUDIO_AS_FORMAT_SPECIFIC:
  332.                             return DisplayASFormatSpecific(CommonDesc);
  334.                         default:
  335.                             break;
  336.                     }
  337.                     break;
  339.                 default:
  340.                     break;
  341.             }
  342.             break;
  344.         case USB_AUDIO_CS_ENDPOINT:
  345.             return DisplayCSEndpoint((PUSB_AUDIO_ENDPOINT_DESCRIPTOR)CommonDesc);
  347.         default:
  348.             break;
  349.     }
  351.     return FALSE;
  352. }
  355. //*****************************************************************************
  356. //
  357. // DisplayACHeader()
  358. //
  359. //*****************************************************************************
  361. BOOL
  362. DisplayACHeader (
  363.     PUSB_AUDIO_AC_INTERFACE_HEADER_DESCRIPTOR HeaderDesc
  364. )
  365. {
  366.     UINT i;
  368.     if (HeaderDesc->bLength < sizeof(USB_AUDIO_AC_INTERFACE_HEADER_DESCRIPTOR))
  369.     {
  370.         OOPS();
  371.         return FALSE;
  372.     }
  374.     AppendTextBuffer("rnAudio Control Interface Header Descriptor:rn");
  376.     AppendTextBuffer("bLength:              0x%02Xrn",
  377.                      HeaderDesc->bLength);
  379.     AppendTextBuffer("bDescriptorType:      0x%02Xrn",
  380.                      HeaderDesc->bDescriptorType);
  382.     AppendTextBuffer("bDescriptorSubtype:   0x%02Xrn",
  383.                      HeaderDesc->bDescriptorSubtype);
  385.     AppendTextBuffer("bcdADC:             0x%04Xrn",
  386.                      HeaderDesc->bcdADC);
  388.     AppendTextBuffer("wTotalLength:       0x%04Xrn",
  389.                      HeaderDesc->wTotalLength);
  391.     AppendTextBuffer("bInCollection:        0x%02Xrn",
  392.                      HeaderDesc->bInCollection);
  394.     for (i=0; i<HeaderDesc->bInCollection; i++)
  395.     {
  396.         AppendTextBuffer("baInterfaceNr[%d]:     0x%02Xrn",
  397.                          i+1,
  398.                          HeaderDesc->baInterfaceNr[i]);
  399.     }
  401.     return TRUE;
  402. }
  405. //*****************************************************************************
  406. //
  407. // DisplayACInputTerminal()
  408. //
  409. //*****************************************************************************
  411. BOOL
  412. DisplayACInputTerminal (
  413.     PUSB_AUDIO_INPUT_TERMINAL_DESCRIPTOR ITDesc
  414. )
  415. {
  416.     PCHAR pStr;
  418.     if (ITDesc->bLength != sizeof(USB_AUDIO_INPUT_TERMINAL_DESCRIPTOR))
  419.     {
  420.         OOPS();
  421.         return FALSE;
  422.     }
  424.     AppendTextBuffer("rnAudio Control Input Terminal Descriptor:rn");
  426.     AppendTextBuffer("bLength:              0x%02Xrn",
  427.                      ITDesc->bLength);
  429.     AppendTextBuffer("bDescriptorType:      0x%02Xrn",
  430.                      ITDesc->bDescriptorType);
  432.     AppendTextBuffer("bDescriptorSubtype:   0x%02Xrn",
  433.                      ITDesc->bDescriptorSubtype);
  435.     AppendTextBuffer("bTerminalID:          0x%02Xrn",
  436.                      ITDesc->bTerminalID);
  438.     AppendTextBuffer("wTerminalType:      0x%04X",
  439.                      ITDesc->wTerminalType);
  441.     pStr = TermTypeCodeToName(ITDesc->wTerminalType);
  443.     if (pStr)
  444.     {
  445.         AppendTextBuffer(" (%s)rn",
  446.                          pStr);
  447.     }
  448.     else
  449.     {
  450.         AppendTextBuffer("rn");
  451.     }
  453.     AppendTextBuffer("bAssocTerminal:       0x%02Xrn",
  454.                      ITDesc->bAssocTerminal);
  456.     AppendTextBuffer("bNrChannels:          0x%02Xrn",
  457.                      ITDesc->bNrChannels);
  459.     AppendTextBuffer("wChannelConfig:     0x%04Xrn",
  460.                      ITDesc->wChannelConfig);
  462.     AppendTextBuffer("iChannelNames:        0x%02Xrn",
  463.                      ITDesc->iChannelNames);
  465.     AppendTextBuffer("iTerminal:            0x%02Xrn",
  466.                      ITDesc->iTerminal);
  469.     return TRUE;
  470. }
  473. //*****************************************************************************
  474. //
  475. // DisplayACOutputTerminal()
  476. //
  477. //*****************************************************************************
  479. BOOL
  480. DisplayACOutputTerminal (
  481.     PUSB_AUDIO_OUTPUT_TERMINAL_DESCRIPTOR OTDesc
  482. )
  483. {
  484.     PCHAR pStr;
  486.     if (OTDesc->bLength != sizeof(USB_AUDIO_OUTPUT_TERMINAL_DESCRIPTOR))
  487.     {
  488.         OOPS();
  489.         return FALSE;
  490.     }
  492.     AppendTextBuffer("rnAudio Control Output Terminal Descriptor:rn");
  494.     AppendTextBuffer("bLength:              0x%02Xrn",
  495.                      OTDesc->bLength);
  497.     AppendTextBuffer("bDescriptorType:      0x%02Xrn",
  498.                      OTDesc->bDescriptorType);
  500.     AppendTextBuffer("bDescriptorSubtype:   0x%02Xrn",
  501.                      OTDesc->bDescriptorSubtype);
  503.     AppendTextBuffer("bTerminalID:          0x%02Xrn",
  504.                      OTDesc->bTerminalID);
  506.     AppendTextBuffer("wTerminalType:      0x%04X",
  507.                      OTDesc->wTerminalType);
  509.     pStr = TermTypeCodeToName(OTDesc->wTerminalType);
  511.     if (pStr)
  512.     {
  513.         AppendTextBuffer(" (%s)rn",
  514.                          pStr);
  515.     }
  516.     else
  517.     {
  518.         AppendTextBuffer("rn");
  519.     }
  521.     AppendTextBuffer("bAssocTerminal:       0x%02Xrn",
  522.                      OTDesc->bAssocTerminal);
  524.     AppendTextBuffer("bSoruceID:            0x%02Xrn",
  525.                      OTDesc->bSoruceID);
  527.     AppendTextBuffer("iTerminal:            0x%02Xrn",
  528.                      OTDesc->iTerminal);
  531.     return TRUE;
  532. }
  535. //*****************************************************************************
  536. //
  537. // DisplayACMixerUnit()
  538. //
  539. //*****************************************************************************
  541. BOOL
  542. DisplayACMixerUnit (
  543.     PUSB_AUDIO_MIXER_UNIT_DESCRIPTOR MixerDesc
  544. )
  545. {
  546.     UCHAR  i;
  547.     PUCHAR data;
  549.     if (MixerDesc->bLength < 10)
  550.     {
  551.         OOPS();
  552.         return FALSE;
  553.     }
  555.     AppendTextBuffer("rnAudio Control Mixer Unit Descriptor:rn");
  557.     AppendTextBuffer("bLength:              0x%02Xrn",
  558.                      MixerDesc->bLength);
  560.     AppendTextBuffer("bDescriptorType:      0x%02Xrn",
  561.                      MixerDesc->bDescriptorType);
  563.     AppendTextBuffer("bDescriptorSubtype:   0x%02Xrn",
  564.                      MixerDesc->bDescriptorSubtype);
  566.     AppendTextBuffer("bUnitID:              0x%02Xrn",
  567.                      MixerDesc->bUnitID);
  569.     AppendTextBuffer("bNrInPins:            0x%02Xrn",
  570.                      MixerDesc->bNrInPins);
  572.     for (i=0; i<MixerDesc->bNrInPins; i++)
  573.     {
  574.         AppendTextBuffer("baSourceID[%d]:        0x%02Xrn",
  575.                         i+1,
  576.                         MixerDesc->baSourceID[i]);
  577.     }
  579.     data = &MixerDesc->baSourceID[MixerDesc->bNrInPins];
  581.     AppendTextBuffer("bNrChannels:          0x%02Xrn",
  582.                      *data++);
  584.     AppendTextBuffer("wChannelConfig:     0x%04Xrn",
  585.                      *((PUSHORT)data)++);
  587.     AppendTextBuffer("iChannelNames:        0x%02Xrn",
  588.                      *data++);
  590.     AppendTextBuffer("bmControls:rn");
  592.     i = MixerDesc->bLength - 10 - MixerDesc->bNrInPins;
  594.     DisplayBytes(data, i);
  596.     data += i;
  598.     AppendTextBuffer("iMixer:               0x%02Xrn",
  599.                      *data);
  601.     return TRUE;
  602. }
  605. //*****************************************************************************
  606. //
  607. // DisplayACSelectorUnit()
  608. //
  609. //*****************************************************************************
  611. BOOL
  612. DisplayACSelectorUnit (
  613.     PUSB_AUDIO_SELECTOR_UNIT_DESCRIPTOR SelectorDesc
  614. )
  615. {
  616.     UCHAR  i;
  617.     PUCHAR data;
  619.     if (SelectorDesc->bLength < 6)
  620.     {
  621.         OOPS();
  622.         return FALSE;
  623.     }
  625.     AppendTextBuffer("rnAudio Control Selector Unit Descriptor:rn");
  627.     AppendTextBuffer("bLength:              0x%02Xrn",
  628.                      SelectorDesc->bLength);
  630.     AppendTextBuffer("bDescriptorType:      0x%02Xrn",
  631.                      SelectorDesc->bDescriptorType);
  633.     AppendTextBuffer("bDescriptorSubtype:   0x%02Xrn",
  634.                      SelectorDesc->bDescriptorSubtype);
  636.     AppendTextBuffer("bUnitID:              0x%02Xrn",
  637.                      SelectorDesc->bUnitID);
  639.     AppendTextBuffer("bNrInPins:            0x%02Xrn",
  640.                      SelectorDesc->bNrInPins);
  642.     for (i=0; i<SelectorDesc->bNrInPins; i++)
  643.     {
  644.         AppendTextBuffer("baSourceID[%d]:        0x%02Xrn",
  645.                         i+1,
  646.                         SelectorDesc->baSourceID[i]);
  647.     }
  649.     data = &SelectorDesc->baSourceID[SelectorDesc->bNrInPins];
  651.     AppendTextBuffer("iSelector:            0x%02Xrn",
  652.                      *data);
  654.     return TRUE;
  655. }
  658. //*****************************************************************************
  659. //
  660. // DisplayACFeatureUnit()
  661. //
  662. //*****************************************************************************
  664. BOOL
  665. DisplayACFeatureUnit (
  666.     PUSB_AUDIO_FEATURE_UNIT_DESCRIPTOR FeatureDesc
  667. )
  668. {
  669.     UCHAR  i, n, ch;
  670.     PUCHAR data;
  672.     if (FeatureDesc->bLength < 7)
  673.     {
  674.         OOPS();
  675.         return FALSE;
  676.     }
  678.     n = FeatureDesc->bControlSize;
  680.     ch = ((FeatureDesc->bLength - 7) / n) - 1;
  682.     if (FeatureDesc->bLength != (7 + (ch + 1) * n))
  683.     {
  684.         OOPS();
  685.         return FALSE;
  686.     }
  688.     AppendTextBuffer("rnAudio Control Feature Unit Descriptor:rn");
  690.     AppendTextBuffer("bLength:              0x%02Xrn",
  691.                      FeatureDesc->bLength);
  693.     AppendTextBuffer("bDescriptorType:      0x%02Xrn",
  694.                      FeatureDesc->bDescriptorType);
  696.     AppendTextBuffer("bDescriptorSubtype:   0x%02Xrn",
  697.                      FeatureDesc->bDescriptorSubtype);
  699.     AppendTextBuffer("bUnitID:              0x%02Xrn",
  700.                      FeatureDesc->bUnitID);
  702.     AppendTextBuffer("bSourceID:            0x%02Xrn",
  703.                      FeatureDesc->bSourceID);
  705.     AppendTextBuffer("bControlSize:         0x%02Xrn",
  706.                      FeatureDesc->bControlSize);
  708.     data = &FeatureDesc->bmaControls[0];
  710.     for (i=0; i<=ch; i++)
  711.     {
  712.         AppendTextBuffer("bmaControls[%d]:rn",
  713.                          i);
  715.         DisplayBytes(data, n);
  717.         data += n;
  718.     }
  720.     AppendTextBuffer("iFeature:             0x%02Xrn",
  721.                      *data);
  723.     return TRUE;
  724. }
  727. //*****************************************************************************
  728. //
  729. // DisplayACProcessingUnit()
  730. //
  731. //*****************************************************************************
  733. BOOL
  734. DisplayACProcessingUnit (
  735.     PUSB_AUDIO_PROCESSING_UNIT_DESCRIPTOR ProcessingDesc
  736. )
  737. {
  738.     UCHAR  i;
  739.     PUCHAR data;
  741.     if (ProcessingDesc->bLength < sizeof(USB_AUDIO_PROCESSING_UNIT_DESCRIPTOR))
  742.     {
  743.         OOPS();
  744.         return FALSE;
  745.     }
  747.     AppendTextBuffer("rnAudio Control Processing Unit Descriptor:rn");
  749.     AppendTextBuffer("bLength:              0x%02Xrn",
  750.                      ProcessingDesc->bLength);
  752.     AppendTextBuffer("bDescriptorType:      0x%02Xrn",
  753.                      ProcessingDesc->bDescriptorType);
  755.     AppendTextBuffer("bDescriptorSubtype:   0x%02Xrn",
  756.                      ProcessingDesc->bDescriptorSubtype);
  758.     AppendTextBuffer("bUnitID:              0x%02Xrn",
  759.                      ProcessingDesc->bUnitID);
  761.     AppendTextBuffer("wProcessType:       0x%04X",
  762.                      ProcessingDesc->wProcessType);
  764.     switch (ProcessingDesc->wProcessType)
  765.     {
  766.         case USB_AUDIO_PROCESS_UNDEFINED:
  767.             AppendTextBuffer("(Undefined Process)rn");
  768.             break;
  770.         case USB_AUDIO_PROCESS_UPDOWNMIX:
  771.             AppendTextBuffer("(Up / Down Mix Process)rn");
  772.             break;
  774.         case USB_AUDIO_PROCESS_DOLBYPROLOGIC:
  775.             AppendTextBuffer("(Dolby Prologic Process)rn");
  776.             break;
  778.         case USB_AUDIO_PROCESS_3DSTEREOEXTENDER:
  779.             AppendTextBuffer("(3D-Stereo Extender Process)rn");
  780.             break;
  782.         case USB_AUDIO_PROCESS_REVERBERATION:
  783.             AppendTextBuffer("(Reverberation Process)rn");
  784.             break;
  786.         case USB_AUDIO_PROCESS_CHORUS:
  787.             AppendTextBuffer("(Chorus Process)rn");
  788.             break;
  790.         case USB_AUDIO_PROCESS_DYNRANGECOMP:
  791.             AppendTextBuffer("(Dynamic Range Compressor Process)rn");
  792.             break;
  794.         default:
  795.             AppendTextBuffer("rn");
  796.             break;
  797.     }
  799.     AppendTextBuffer("bNrInPins:            0x%02Xrn",
  800.                      ProcessingDesc->bNrInPins);
  802.     for (i=0; i<ProcessingDesc->bNrInPins; i++)
  803.     {
  804.         AppendTextBuffer("baSourceID[%d]:        0x%02Xrn",
  805.                         i+1,
  806.                         ProcessingDesc->baSourceID[i]);
  807.     }
  809.     data = &ProcessingDesc->baSourceID[ProcessingDesc->bNrInPins];
  811.     AppendTextBuffer("bNrChannels:          0x%02Xrn",
  812.                      *data++);
  814.     AppendTextBuffer("wChannelConfig:     0x%04Xrn",
  815.                      *((PUSHORT)data)++);
  817.     AppendTextBuffer("iChannelNames:        0x%02Xrn",
  818.                      *data++);
  820.     i = *data++;
  822.     AppendTextBuffer("bControlSize:         0x%02Xrn",
  823.                      i);
  825.     AppendTextBuffer("bmControls:rn");
  827.     DisplayBytes(data, i);
  829.     data += i;
  831.     AppendTextBuffer("iProcessing:          0x%02Xrn",
  832.                      *data++);
  835.     i = ProcessingDesc->bLength - 13 - ProcessingDesc->bNrInPins - i;
  837.     if (i)
  838.     {
  839.         AppendTextBuffer("Process Specific:rn");
  841.         DisplayBytes(data, i);
  842.     }
  844.     return TRUE;
  845. }
  848. //*****************************************************************************
  849. //
  850. // DisplayACExtensionUnit()
  851. //
  852. //*****************************************************************************
  854. BOOL
  855. DisplayACExtensionUnit (
  856.     PUSB_AUDIO_EXTENSION_UNIT_DESCRIPTOR ExtensionDesc
  857. )
  858. {
  859.     UCHAR  i;
  860.     PUCHAR data;
  862.     if (ExtensionDesc->bLength < 13)
  863.     {
  864.         OOPS();
  865.         return FALSE;
  866.     }
  868.     AppendTextBuffer("rnAudio Control Extension Unit Descriptor:rn");
  870.     AppendTextBuffer("bLength:              0x%02Xrn",
  871.                      ExtensionDesc->bLength);
  873.     AppendTextBuffer("bDescriptorType:      0x%02Xrn",
  874.                      ExtensionDesc->bDescriptorType);
  876.     AppendTextBuffer("bDescriptorSubtype:   0x%02Xrn",
  877.                      ExtensionDesc->bDescriptorSubtype);
  879.     AppendTextBuffer("bUnitID:              0x%02Xrn",
  880.                      ExtensionDesc->bUnitID);
  882.     AppendTextBuffer("wExtensionCode:     0x%04Xrn",
  883.                      ExtensionDesc->wExtensionCode);
  886.     AppendTextBuffer("bNrInPins:            0x%02Xrn",
  887.                      ExtensionDesc->bNrInPins);
  889.     for (i=0; i<ExtensionDesc->bNrInPins; i++)
  890.     {
  891.         AppendTextBuffer("baSourceID[%d]:        0x%02Xrn",
  892.                         i+1,
  893.                         ExtensionDesc->baSourceID[i]);
  894.     }
  896.     data = &ExtensionDesc->baSourceID[ExtensionDesc->bNrInPins];
  898.     AppendTextBuffer("bNrChannels:          0x%02Xrn",
  899.                      *data++);
  901.     AppendTextBuffer("wChannelConfig:     0x%04Xrn",
  902.                      *((PUSHORT)data)++);
  904.     AppendTextBuffer("iChannelNames:        0x%02Xrn",
  905.                      *data++);
  907.     i = *data++;
  909.     AppendTextBuffer("bControlSize:         0x%02Xrn",
  910.                      i);
  912.     AppendTextBuffer("bmControls:rn");
  914.     DisplayBytes(data, i);
  916.     data += i;
  918.     AppendTextBuffer("iExtension:           0x%02Xrn",
  919.                      *data);
  920.     return TRUE;
  921. }
  924. //*****************************************************************************
  925. //
  926. // DisplayASGeneral()
  927. //
  928. //*****************************************************************************
  930. BOOL
  931. DisplayASGeneral (
  932.     PUSB_AUDIO_GENERAL_DESCRIPTOR GeneralDesc
  933. )
  934. {
  935.     PCHAR pStr;
  937.     if (GeneralDesc->bLength != sizeof(USB_AUDIO_GENERAL_DESCRIPTOR))
  938.     {
  939.         OOPS();
  940.         return FALSE;
  941.     }
  943.     AppendTextBuffer("rnAudio Streaming Class Specific Interface Descriptor:rn");
  945.     AppendTextBuffer("bLength:              0x%02Xrn",
  946.                      GeneralDesc->bLength);
  948.     AppendTextBuffer("bDescriptorType:      0x%02Xrn",
  949.                      GeneralDesc->bDescriptorType);
  951.     AppendTextBuffer("bDescriptorSubtype:   0x%02Xrn",
  952.                      GeneralDesc->bDescriptorSubtype);
  954.     AppendTextBuffer("bTerminalLink:        0x%02Xrn",
  955.                      GeneralDesc->bTerminalLink);
  957.     AppendTextBuffer("bDelay:               0x%02Xrn",
  958.                      GeneralDesc->bDelay);
  960.     AppendTextBuffer("wFormatTag:         0x%04X",
  961.                      GeneralDesc->wFormatTag);
  963.     pStr = FormatTypeCodeToName(GeneralDesc->wFormatTag);
  965.     if (pStr)
  966.     {
  967.         AppendTextBuffer(" (%s)rn",
  968.                          pStr);
  969.     }
  970.     else
  971.     {
  972.         AppendTextBuffer("rn");
  973.     }
  975.     return TRUE;
  976. }
  979. //*****************************************************************************
  980. //
  981. // DisplayCSEndpoint()
  982. //
  983. //*****************************************************************************
  985. BOOL
  986. DisplayCSEndpoint (
  987.     PUSB_AUDIO_ENDPOINT_DESCRIPTOR EndpointDesc
  988. )
  989. {
  990.     if (EndpointDesc->bLength != sizeof(USB_AUDIO_ENDPOINT_DESCRIPTOR))
  991.     {
  992.         OOPS();
  993.         return FALSE;
  994.     }
  996.     AppendTextBuffer("rnAudio Streaming Class Specific Audio Data Endpoint Descriptor:rn");
  998.     AppendTextBuffer("bLength:              0x%02Xrn",
  999.                      EndpointDesc->bLength);
  1001.     AppendTextBuffer("bDescriptorType:      0x%02Xrn",
  1002.                      EndpointDesc->bDescriptorType);
  1004.     AppendTextBuffer("bDescriptorSubtype:   0x%02Xrn",
  1005.                      EndpointDesc->bDescriptorSubtype);
  1007.     AppendTextBuffer("bmAttributes:         0x%02Xrn",
  1008.                      EndpointDesc->bmAttributes);
  1010.     AppendTextBuffer("bLockDelayUnits:      0x%02Xrn",
  1011.                      EndpointDesc->bLockDelayUnits);
  1013.     AppendTextBuffer("wLockDelay:         0x%04Xrn",
  1014.                      EndpointDesc->wLockDelay);
  1016.     return TRUE;
  1017. }
  1020. //*****************************************************************************
  1021. //
  1022. // DisplayASFormatType()
  1023. //
  1024. //*****************************************************************************
  1026. BOOL
  1027. DisplayASFormatType (
  1028.     PUSB_AUDIO_COMMON_FORMAT_DESCRIPTOR FormatDesc
  1029. )
  1030. {
  1031.     UCHAR  i, n;
  1032.     ULONG  freq;
  1033.     PUCHAR data;
  1035.     if (FormatDesc->bLength < sizeof(USB_AUDIO_COMMON_FORMAT_DESCRIPTOR))
  1036.     {
  1037.         OOPS();
  1038.         return FALSE;
  1039.     }
  1041.     AppendTextBuffer("rnAudio Streaming Format Type Descriptor:rn");
  1043.     AppendTextBuffer("bLength:              0x%02Xrn",
  1044.                      FormatDesc->bLength);
  1046.     AppendTextBuffer("bDescriptorType:      0x%02Xrn",
  1047.                      FormatDesc->bDescriptorType);
  1049.     AppendTextBuffer("bDescriptorSubtype:   0x%02Xrn",
  1050.                      FormatDesc->bDescriptorSubtype);
  1052.     AppendTextBuffer("bFormatType:          0x%02Xrn",
  1053.                      FormatDesc->bFormatType);
  1056.     if (FormatDesc->bFormatType == 0x01 ||
  1057.         FormatDesc->bFormatType == 0x03)
  1058.     {
  1059.         PUSB_AUDIO_TYPE_I_OR_III_FORMAT_DESCRIPTOR FormatI_IIIDesc;
  1061.         FormatI_IIIDesc = (PUSB_AUDIO_TYPE_I_OR_III_FORMAT_DESCRIPTOR)FormatDesc;
  1063.         AppendTextBuffer("bNrChannels:          0x%02Xrn",
  1064.                          FormatI_IIIDesc->bNrChannels);
  1066.         AppendTextBuffer("bSubframeSize:        0x%02Xrn",
  1067.                          FormatI_IIIDesc->bSubframeSize);
  1069.         AppendTextBuffer("bBitResolution:       0x%02Xrn",
  1070.                          FormatI_IIIDesc->bBitResolution);
  1072.         AppendTextBuffer("bSamFreqType:         0x%02Xrn",
  1073.                          FormatI_IIIDesc->bSamFreqType);
  1075.         data = (PUCHAR)(FormatI_IIIDesc + 1);
  1077.         n = FormatI_IIIDesc->bSamFreqType;
  1079.     }
  1080.     else if (FormatDesc->bFormatType == 0x02)
  1081.     {
  1082.         PUSB_AUDIO_TYPE_II_FORMAT_DESCRIPTOR FormatIIDesc;
  1084.         FormatIIDesc = (PUSB_AUDIO_TYPE_II_FORMAT_DESCRIPTOR)FormatDesc;
  1086.         AppendTextBuffer("wMaxBitRate:        0x%04Xrn",
  1087.                          FormatIIDesc->wMaxBitRate);
  1089.         AppendTextBuffer("wSamplesPerFrame:   0x%04Xrn",
  1090.                          FormatIIDesc->wSamplesPerFrame);
  1092.         AppendTextBuffer("bSamFreqType:         0x%02Xrn",
  1093.                          FormatIIDesc->bSamFreqType);
  1095.         data = (PUCHAR)(FormatIIDesc + 1);
  1097.         n = FormatIIDesc->bSamFreqType;
  1099.     }
  1100.     else
  1101.     {
  1102.         data = NULL;
  1103.     }
  1105.     if (data != NULL)
  1106.     {
  1107.         if (n == 0)
  1108.         {
  1109.             freq = (data[0]) + (data[1] << 8) + (data[2] << 16);
  1110.             data += 3;
  1112.             AppendTextBuffer("tLowerSamFreq:    0x%06X (%d Hz)rn",
  1113.                              freq,
  1114.                              freq);
  1116.             freq = (data[0]) + (data[1] << 8) + (data[2] << 16);
  1117.             data += 3;
  1119.             AppendTextBuffer("tUpperSamFreq:    0x%06X (%d Hz)rn",
  1120.                              freq,
  1121.                              freq);
  1122.         }
  1123.         else
  1124.         {
  1125.             for (i=0; i<n; i++)
  1126.             {
  1127.                 freq = (data[0]) + (data[1] << 8) + (data[2] << 16);
  1128.                 data += 3;
  1130.                 AppendTextBuffer("tSamFreq[%d]:      0x%06X (%d Hz)rn",
  1131.                                  i+1,
  1132.                                  freq,
  1133.                                  freq);
  1134.             }
  1135.         }
  1136.     }
  1138.     return TRUE;
  1139. }
  1142. //*****************************************************************************
  1143. //
  1144. // DisplayASFormatSpecific()
  1145. //
  1146. //*****************************************************************************
  1148. BOOL
  1149. DisplayASFormatSpecific (
  1150.     PUSB_AUDIO_COMMON_DESCRIPTOR CommonDesc
  1151. )
  1152. {
  1153.     AppendTextBuffer("rnAudio Streaming Format Specific Descriptor:rn");
  1155.     AppendTextBuffer("bLength:              0x%02Xrn",
  1156.                      CommonDesc->bLength);
  1158.     AppendTextBuffer("bDescriptorType:      0x%02Xrn",
  1159.                      CommonDesc->bDescriptorType);
  1161.     AppendTextBuffer("bDescriptorSubtype:   0x%02Xrn",
  1162.                      CommonDesc->bDescriptorSubtype);
  1164.     DisplayBytes((PUCHAR)(CommonDesc + 1),
  1165.                  CommonDesc->bLength);
  1167.     return TRUE;
  1168. }
  1170. //*****************************************************************************
  1171. //
  1172. // DisplayBytes()
  1173. //
  1174. //*****************************************************************************
  1176. VOID
  1177. DisplayBytes (
  1178.     PUCHAR Data,
  1179.     USHORT Len
  1180. )
  1181. {
  1182.     USHORT i;
  1184.     for (i = 0; i < Len; i++)
  1185.     {
  1186.         AppendTextBuffer("%02X ",
  1187.                          Data[i]);
  1189.         if (i % 16 == 15)
  1190.         {
  1191.             AppendTextBuffer("rn");
  1192.         }
  1193.     }
  1195.     if (i % 16 != 0)
  1196.     {
  1197.         AppendTextBuffer("rn");
  1198.     }
  1199. }
  1202. //*****************************************************************************
  1203. //
  1204. // TermTypeCodeToName()
  1205. //
  1206. //*****************************************************************************
  1208. PCHAR
  1209. TermTypeCodeToName (
  1210.     USHORT TermTypeCode
  1211. )
  1212. {
  1213.     PTERMTYPE termType;
  1215.     for (termType=TermTypes; termType->TermTypeName; termType++)
  1216.     {
  1217.         if (termType->TermTypeCode == TermTypeCode)
  1218.         {
  1219.             break;
  1220.         }
  1221.     }
  1223.     return termType->TermTypeName;
  1224. }
  1227. //*****************************************************************************
  1228. //
  1229. // FormatTypeCodeToName()
  1230. //
  1231. //*****************************************************************************
  1233. PCHAR
  1234. FormatTypeCodeToName (
  1235.     USHORT FormatTypeCode
  1236. )
  1237. {
  1238.     PFORMATTYPE formatType;
  1240.     for (formatType=FormatTypes; formatType->FormatTypeName; formatType++)
  1241.     {
  1242.         if (formatType->FormatTypeCode == FormatTypeCode)
  1243.         {
  1244.             break;
  1245.         }
  1246.     }
  1248.     return formatType->FormatTypeName;
  1249. }