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/include/freerdp/codecs.h
+++ b/third_party/FreeRDP/include/freerdp/codecs.h
@@ -0,0 +1,115 @@
+/**
+ * FreeRDP: A Remote Desktop Protocol Implementation
+ * RDP Codecs
+ *
+ * Copyright 2014 Marc-Andre Moreau <marcandre.moreau@gmail.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_CODECS_H
+#define FREERDP_CODECS_H
+
+#include <freerdp/api.h>
+#include <freerdp/types.h>
+
+#include <freerdp/codec/color.h>
+
+#include <freerdp/codec/rfx.h>
+#include <freerdp/codec/nsc.h>
+#include <freerdp/codec/h264.h>
+#include <freerdp/codec/clear.h>
+#include <freerdp/codec/planar.h>
+#include <freerdp/codec/interleaved.h>
+#include <freerdp/codec/progressive.h>
+
+typedef enum
+{
+	FREERDP_CODEC_INTERLEAVED = 0x00000001,
+	FREERDP_CODEC_PLANAR = 0x00000002,
+	FREERDP_CODEC_NSCODEC = 0x00000004,
+	FREERDP_CODEC_REMOTEFX = 0x00000008,
+	FREERDP_CODEC_CLEARCODEC = 0x00000010,
+	FREERDP_CODEC_ALPHACODEC = 0x00000020,
+	FREERDP_CODEC_PROGRESSIVE = 0x00000040,
+	FREERDP_CODEC_AVC420 = 0x00000080,
+	FREERDP_CODEC_AVC444 = 0x00000100,
+	FREERDP_CODEC_ALL = 0x7FFFFFFF /* C enum types are restricted to int */
+} FreeRDP_CodecFlags;
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+	struct rdp_codecs
+	{
+		UINT32 ThreadingFlags; /** @since version 3.6.0 */
+
+		RFX_CONTEXT* rfx;
+		NSC_CONTEXT* nsc;
+		H264_CONTEXT* h264;
+		CLEAR_CONTEXT* clear;
+		PROGRESSIVE_CONTEXT* progressive;
+		BITMAP_PLANAR_CONTEXT* planar;
+		BITMAP_INTERLEAVED_CONTEXT* interleaved;
+	};
+	typedef struct rdp_codecs rdpCodecs;
+
+	WINPR_ATTR_NODISCARD
+	FREERDP_API BOOL freerdp_client_codecs_prepare(rdpCodecs* codecs, UINT32 flags, UINT32 width,
+	                                               UINT32 height);
+
+	WINPR_ATTR_NODISCARD
+	FREERDP_API BOOL freerdp_client_codecs_reset(rdpCodecs* codecs, UINT32 flags, UINT32 width,
+	                                             UINT32 height);
+
+	/**
+	 * @brief Free a rdpCodecs instance
+	 * @param codecs A pointer to a rdpCodecs instance or nullptr
+	 *  @since version 3.6.0
+	 */
+	FREERDP_API void freerdp_client_codecs_free(rdpCodecs* codecs);
+
+	/**
+	 * @brief Allocate a rdpCodecs instance.
+	 * @return A newly allocated instance or \b nullptr in case of failure.
+	 *  @since version 3.6.0
+	 */
+	WINPR_ATTR_MALLOC(freerdp_client_codecs_free, 1)
+	WINPR_ATTR_NODISCARD
+	FREERDP_API rdpCodecs* freerdp_client_codecs_new(UINT32 ThreadingFlags);
+
+#if !defined(WITHOUT_FREERDP_3x_DEPRECATED)
+	WINPR_DEPRECATED_VAR("[since 3.6.0] Use freerdp_client_codecs_free",
+	                     FREERDP_API void codecs_free(rdpCodecs* codecs));
+
+	WINPR_DEPRECATED_VAR(
+	    "[since 3.6.0] Use freerdp_client_codecs_new",
+	    WINPR_ATTR_MALLOC(codecs_free, 1)
+	        WINPR_ATTR_NODISCARD FREERDP_API rdpCodecs* codecs_new(rdpContext* context));
+#endif
+
+	/** @brief return a string representation of the given codecid
+	 * 	 *  @param id The codec to stringify
+	 *  @return The name of the codecid
+	 *  @since version 3.18.0
+	 */
+	WINPR_ATTR_NODISCARD
+	FREERDP_API const char* freerdp_codec_id_to_str(UINT32 id);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* FREERDP_CODECS_H */