Changeset 89935 in vbox for trunk/include

Timestamp:

Jun 29, 2021 6:38:48 AM (4 years ago)

Author:

vboxsync

Message:

Keyboard: Reworked the release-all-keys mechanism, made sure it's used before switching active keyboard, avoided potential mix-ups when tracking depressed keys (see bugref:10045).

File:

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

trunk/include/VBox/vmm/pdmifs.h

@@ -399 +399 @@
 
 
+/** Flags for PDMIKEYBOARDPORT::pfnPutEventHid.
+ * @{ */
+#define PDMIKBDPORT_KEY_UP          RT_BIT(31)  /** Key release event if set. */
+#define PDMIKBDPORT_RELEASE_KEYS    RT_BIT(30)  /** Force all keys to be released. */
+/** @} */
+
+/** USB HID usage pages understood by PDMIKEYBOARDPORT::pfnPutEventHid.
+ * @{ */
+#define USB_HID_DC_PAGE             1       /** USB HID Generic Desktop Control Usage Page. */
+#define USB_HID_KB_PAGE             7       /** USB HID Keyboard Usage Page. */
+#define USB_HID_CC_PAGE             12      /** USB HID Consumer Control Usage Page. */
+/** @} */
+
+
 /** Pointer to a keyboard port interface. */
 typedef struct PDMIKEYBOARDPORT *PPDMIKEYBOARDPORT;
@@ -434 +448 @@
      */
     DECLR3CALLBACKMEMBER(int, pfnPutEventHid,(PPDMIKEYBOARDPORT pInterface, uint32_t idUsage));
+
+    /**
+     * Forcibly releases any pressed keys.
+     *
+     * This is called by the source of keyboard events in situations when a full
+     * release of all currently pressed keys must be forced, e.g. when activating
+     * a different keyboard, or when key-up events may have been lost.
+     *
+     * @returns VBox status code.
+     *
+     * @param   pInterface          Pointer to this interface structure.
+     */
+    DECLR3CALLBACKMEMBER(int, pfnReleaseKeys,(PPDMIKEYBOARDPORT pInterface));
 } PDMIKEYBOARDPORT;
 /** PDMIKEYBOARDPORT interface ID. */