Introduce USB MIDI descriptor parser

media/midi/usb_midi_descriptor_parser.h

+// Copyright (c) 2013 The Chromium Authors. All rights reserved.

[DaleCurtis, 2014/01/03 00:56:49]

No (c) for the year anymore.

[yhirano, 2014/01/09 08:33:13]

Done.

+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef MEDIA_MIDI_USB_MIDI_DESCRIPTOR_PARSER_H_
+#define MEDIA_MIDI_USB_MIDI_DESCRIPTOR_PARSER_H_
+
+#include <vector>
+
+#include "base/basictypes.h"
+#include "base/containers/hash_tables.h"
+#include "media/base/media_export.h"
+#include "media/midi/usb_midi_jack.h"
+
+namespace media {
+
+class UsbMidiDevice;
+
+// UsbMidiDescriptorParser parses USB descriptors and
+// generates input / output lists of MIDIPortInfo.
+class MEDIA_EXPORT UsbMidiDescriptorParser {
+ public:
+  UsbMidiDescriptorParser();
+  ~UsbMidiDescriptorParser();
+
+  // Returns true if the operation succeeds.
+  // When an incorrect input is given, this method may return true but
+  // never crashes.
+  bool Parse(UsbMidiDevice* device, const uint8* data, size_t size);
+
+  const std::vector<UsbMidiJack>& jacks() const { return jacks_; }
+
+ private:
+  bool ParseInternal(UsbMidiDevice* device, const uint8* data, size_t size);
+  bool ParseInterface(UsbMidiDevice* device, const uint8* data, size_t size);
+  bool ParseCSInterface(UsbMidiDevice* device, const uint8* data, size_t size);
+  bool ParseEndpoint(UsbMidiDevice* device, const uint8* data, size_t size);
+  bool ParseCSEndpoint(UsbMidiDevice* device, const uint8* data, size_t size);
+  void Clear();
+  void ClearExceptJacks();
+
+  bool is_parsing_usb_midi_interface_;
+  uint8 current_endpoint_address_;
+  uint8 current_cable_number_;
+
+  std::vector<UsbMidiJack> jacks_;
+  typedef uint8 JackID;
+  // Embedded MIDI Jacks which will be assosiated with some endpoint,
+  // but is not yet.
+  base::hash_map<JackID, UsbMidiJack> incomplete_jacks_;
+
+  DISALLOW_COPY_AND_ASSIGN(UsbMidiDescriptorParser);
+};
+
+
+}  // namespace media
+
+#endif  // MEDIA_MIDI_USB_MIDI_DESCRIPTOR_PARSER_H_