Changeset 26275 in vbox

Timestamp:

Feb 5, 2010 4:30:19 AM (15 years ago)

Author:

vboxsync

Message:

USB: string descriptor caching for virtual devices.

File:

• trunk/include/VBox/pdmusb.h (modified) (2 diffs)

trunk/include/VBox/pdmusb.h

@@ -52 +52 @@
  */
 
+
+/**
+ * A string entry for the USB descriptor cache.
+ */
+typedef struct PDMUSBDESCCACHESTRING
+{
+    /** The string index. */
+    uint8_t     idx;
+    /** The UTF-8 representation of the string. */
+    const char *psz;
+} PDMUSBDESCCACHESTRING;
+/** Pointer to a const string entry. */
+typedef PDMUSBDESCCACHESTRING const *PCPDMUSBDESCCACHESTRING;
+
+
+/**
+ * A language entry for the USB descriptor cache.
+ */
+typedef struct PDMUSBDESCCACHELANG
+{
+    /** The language ID for the strings in this block. */
+    uint16_t                idLang;
+    /** The number of strings in the array. */
+    uint16_t                cStrings;
+    /** Pointer to an array of associated strings.
+     * This must be sorted in ascending order by string index as a binary lookup
+     * will be performed. */
+    PCPDMUSBDESCCACHESTRING paStrings;
+} PDMUSBDESCCACHELANG;
+/** Pointer to a const language entry. */
+typedef PDMUSBDESCCACHELANG const *PCPDMUSBDESCCACHELANG;
+
+
 /**
  * USB descriptor cache.
@@ -65 +98 @@
 {
     /** USB device descriptor */
-    PCVUSBDESCDEVICE    pDevice;
+    PCVUSBDESCDEVICE        pDevice;
     /** USB Descriptor arrays (pDev->bNumConfigurations) */
-    PCVUSBDESCCONFIGEX  paConfigs;
+    PCVUSBDESCCONFIGEX      paConfigs;
+    /** Language IDs and their associated strings.
+     * This must be sorted in ascending order by language ID as a binary lookup
+     * will be used. */
+    PCPDMUSBDESCCACHELANG   paLanguages;
+    /** The number of entries in the array pointed to by paLanguages. */
+    uint16_t                cLanguages;
     /** Use the cached descriptors for GET_DESCRIPTOR requests. */
-    bool                fUseCachedDescriptors;
+    bool                    fUseCachedDescriptors;
+    /** Use the cached string descriptors. */
+    bool                    fUseCachedStringsDescriptors;
 } PDMUSBDESCCACHE;
 /** Pointer to an USB descriptor cache. */