Milestone 5: deliver embedded RDP sessions and lifecycle hardening

2026-03-03 18:59:26 -07:00
parent 230a401386
commit 36006bd4aa
2941 changed files with 724359 additions and 77 deletions
--- a/third_party/FreeRDP/channels/urbdrc/common/msusb.h
+++ b/third_party/FreeRDP/channels/urbdrc/common/msusb.h
@@ -0,0 +1,111 @@
+/**
+ * FreeRDP: A Remote Desktop Protocol Implementation
+ * RemoteFX USB Redirection
+ *
+ * Copyright 2012 Atrust corp.
+ * Copyright 2012 Alfred Liu <alfred.liu@atruscorp.com>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *	 http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#ifndef FREERDP_UTILS_MSCONFIG_H
+#define FREERDP_UTILS_MSCONFIG_H
+
+#include <winpr/stream.h>
+#include <freerdp/api.h>
+
+typedef struct
+{
+	UINT16 MaximumPacketSize;
+	UINT32 MaximumTransferSize;
+	UINT32 PipeFlags;
+	UINT32 PipeHandle;
+	BYTE bEndpointAddress;
+	BYTE bInterval;
+	BYTE PipeType;
+	int InitCompleted;
+} MSUSB_PIPE_DESCRIPTOR;
+
+typedef struct
+{
+	UINT16 Length;
+	UINT16 NumberOfPipesExpected;
+	BYTE InterfaceNumber;
+	BYTE AlternateSetting;
+	UINT32 NumberOfPipes;
+	UINT32 InterfaceHandle;
+	BYTE bInterfaceClass;
+	BYTE bInterfaceSubClass;
+	BYTE bInterfaceProtocol;
+	MSUSB_PIPE_DESCRIPTOR** MsPipes;
+	int InitCompleted;
+} MSUSB_INTERFACE_DESCRIPTOR;
+
+typedef struct
+{
+	UINT16 wTotalLength;
+	BYTE bConfigurationValue;
+	UINT32 ConfigurationHandle;
+	UINT32 NumInterfaces;
+	MSUSB_INTERFACE_DESCRIPTOR** MsInterfaces;
+	int InitCompleted;
+	int MsOutSize;
+} MSUSB_CONFIG_DESCRIPTOR;
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+	/* MSUSB_CONFIG exported functions */
+	FREERDP_LOCAL void msusb_msconfig_free(MSUSB_CONFIG_DESCRIPTOR* MsConfig);
+
+	WINPR_ATTR_MALLOC(msusb_msconfig_free, 1)
+	WINPR_ATTR_NODISCARD
+	FREERDP_LOCAL MSUSB_CONFIG_DESCRIPTOR* msusb_msconfig_new(void);
+
+	WINPR_ATTR_MALLOC(msusb_msconfig_free, 1)
+	WINPR_ATTR_NODISCARD
+	FREERDP_LOCAL MSUSB_CONFIG_DESCRIPTOR* msusb_msconfig_read(wStream* s, UINT32 NumInterfaces);
+
+	WINPR_ATTR_NODISCARD
+	FREERDP_LOCAL BOOL msusb_msconfig_write(const MSUSB_CONFIG_DESCRIPTOR* MsConfig, wStream* out);
+
+	FREERDP_LOCAL void msusb_msconfig_dump(const MSUSB_CONFIG_DESCRIPTOR* MsConfig);
+
+	/* MSUSB_PIPE exported functions */
+	FREERDP_LOCAL void msusb_mspipes_replace(MSUSB_INTERFACE_DESCRIPTOR* MsInterface,
+	                                         MSUSB_PIPE_DESCRIPTOR** NewMsPipes,
+	                                         UINT32 NewNumberOfPipes);
+
+	/* MSUSB_INTERFACE exported functions */
+	WINPR_ATTR_NODISCARD
+	FREERDP_LOCAL BOOL msusb_msinterface_replace(MSUSB_CONFIG_DESCRIPTOR* MsConfig,
+	                                             BYTE InterfaceNumber,
+	                                             MSUSB_INTERFACE_DESCRIPTOR* NewMsInterface);
+
+	FREERDP_LOCAL void msusb_msinterface_free(MSUSB_INTERFACE_DESCRIPTOR* MsInterface);
+
+	WINPR_ATTR_MALLOC(msusb_msinterface_free, 1)
+	WINPR_ATTR_NODISCARD
+	FREERDP_LOCAL MSUSB_INTERFACE_DESCRIPTOR* msusb_msinterface_read(wStream* s);
+
+	WINPR_ATTR_NODISCARD
+	FREERDP_LOCAL BOOL msusb_msinterface_write(const MSUSB_INTERFACE_DESCRIPTOR* MsInterface,
+	                                           wStream* out);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* FREERDP_UTILS_MSCONFIG_H */