C#調用基於UVC協議的攝像頭擴展介面

来源:https://www.cnblogs.com/log9527blog/archive/2023/03/14/17214022.html
-Advertisement-
Play Games

最近公司增加了一些UVC協議的攝像頭介面，下麵是一些資料整理（感謝項目組內志宇同學的耐心指導） 攝像頭插件為AForge，所以IKsControl介面對象AForge.FilterInfo。（IKsControl介面：提供了控制 KS 過濾器或 KS 引腳的用戶模式方法。參考：https://lea ...


最近公司增加了一些UVC協議的攝像頭介面，下麵是一些資料整理（感謝項目組內志宇同學的耐心指導）

攝像頭插件為AForge，所以IKsControl介面對象AForge.FilterInfo。（IKsControl介面：提供了控制 KS 過濾器或 KS 引腳的用戶模式方法。參考：https://learn.microsoft.com/en-us/windows-hardware/drivers/stream/ks-h-typedef-reference）

/// <summary>
    /// VC01 8K 攝像頭 UVC協議擴展介面
    /// </summary>
    public class Vc01UvcExtension
    {
        /// <summary>
        /// 指定標識內核流方法集的 GUID。
        /// </summary>
        private readonly Guid _ksMethodSetGuid = new("A29E7641-DE04-47E3-8B2B-F4341AFF003B");

        private const string Vc01CameraName = "VC01";

        private IKsControl _pControl;

        /// <summary>
        /// 初始化UVC協議擴展介面
        /// </summary>
        /// <param name="cameraName">攝像頭名稱</param>
        public string Init(string cameraName = "")
        {
            var cameraInfos = CameraDevicesManager.GetCameraInfos();
            if (cameraInfos.Count == 0)
            {
                return "未接入攝像頭";
            }

            if (string.IsNullOrWhiteSpace(cameraName))
            {
                cameraName = Vc01CameraName;
            }

            var vc01CameraInfo = cameraInfos.FirstOrDefault(cameraInfo => cameraInfo.Name.ToUpper().Contains(cameraName));
            if (vc01CameraInfo == null || string.IsNullOrWhiteSpace(vc01CameraInfo.Identity))
            {
                return "未接入8K攝像頭";
            }

            _pControl = FilterInfo.CreateFilter(vc01CameraInfo.Identity) as IKsControl;
            return _pControl == null ? "轉換IKsControl介面失敗" : "";
        }

        /// <summary>
        /// 獲取UVC擴展屬性
        /// </summary>
        /// <param name="type"></param>
        /// <typeparam name="T"></typeparam>
        /// <returns></returns>
        public DvbResult<T> GetUvcExtensionProperty<T>(int type) where T : struct
        {
            var ksProperty = new KsMethod(_ksMethodSetGuid, type, (int)(KsPropertyTypeEnum.KsPropertyTypeGet | KsPropertyTypeEnum.KsPropertyTypeTopology));
            var nod = new KspNode
            {
                Property = ksProperty,
                NodeId = 2,
                Reserved = 0
            };

            var dvbResult = new DvbResult<T>();

            var dataPro = Marshal.AllocHGlobal(Marshal.SizeOf(dvbResult.Data));
            var dataSize = Marshal.SizeOf(dvbResult.Data);
            var dwReturned = 0;
            try
            {
                var hr = _pControl.KsProperty(ref nod.Property, Marshal.SizeOf(nod), dataPro, dataSize, ref dwReturned);
                if (hr != 0 || dwReturned != dataSize)
                    return dvbResult;
                dvbResult.Data = (T)Marshal.PtrToStructure(dataPro, typeof(T));
                dvbResult.Result = 0;
                return dvbResult;
            }
            finally
            {
                Marshal.FreeHGlobal(dataPro);
            }
        }

        /// <summary>
        /// 設置UVC擴展屬性
        /// </summary>
        /// <param name="type"></param>
        /// <param name="data"></param>
        /// <typeparam name="T"></typeparam>
        /// <returns></returns>
        public DvbResult SetUvcExtensionProperty<T>(int type, T data) where T : struct
        {
            var ksProperty = new KsMethod(_ksMethodSetGuid, type, (int)(KsPropertyTypeEnum.KsPropertyTypeSet | KsPropertyTypeEnum.KsPropertyTypeTopology));
            var nod = new KspNode
            {
                Property = ksProperty,
                NodeId = 2,
                Reserved = 0
            };

            var dvbResult = new DvbResult();
            var dataPro = Marshal.AllocHGlobal(Marshal.SizeOf(data));
            var dataSize = Marshal.SizeOf(data);
            var dwReturned = 0;
            try
            {
                Marshal.StructureToPtr(data, dataPro, true);
                var hr = _pControl.KsProperty(ref nod.Property, Marshal.SizeOf(nod), dataPro, dataSize, ref dwReturned);
                if (hr != 0)
                    return dvbResult;
                dvbResult.Result = 0;
                return dvbResult;
            }
            finally
            {
                Marshal.FreeHGlobal(dataPro);
            }
        }
    }
/// <summary>
    /// KsProperty 請求類型
    /// </summary>
    [Flags]
    public enum KsPropertyTypeEnum
    {
        /// <summary>
        /// 傳遞的屬性是KSP_NODE類型，其中 NodeId 表示拓撲節點的數字 ID。不要單獨設置此標誌；相反，將其與該表中的其他標誌進行或運算。
        /// </summary>
        KsPropertyTypeTopology = 0x10000000,

        /// <summary>
        /// 檢索指定屬性項的值。
        /// </summary>
        KsPropertyTypeGet = 0x00000001,

        /// <summary>
        /// 設置指定屬性項的值。
        /// </summary>
        KsPropertyTypeSet = 0x00000002,
    }
/// <summary>
    /// IKsControl介面提供了控制 KS 過濾器或 KS 引腳的用戶模式方法。（參考c語言的Ks.h）
    /// </summary>
    [ComImport, SuppressUnmanagedCodeSecurity,
     Guid("28F54685-06FD-11D2-B27A-00A0C9223196"),
     InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
    public interface IKsControl
    {
        /// <summary>
        /// KsProperty方法設置屬性或檢索屬性信息，以及屬性集上可用的任何其他定義的支持操作。
        /// </summary>
        /// <param name="property">指向描述屬性和屬性請求的請求類型的結構的指針。此結構必須是KSPROPERTY或包含KSPROPERTY結構作為其第一個成員的結構。該成員可以指向的結構示例是KSPROPERTY_VIDEOPROCAMP_S結構。</param>
        /// <param name="propertyLength">Property處緩衝區的大小（以位元組為單位）。</param>
        /// <param name="propertyData">指向包含 KSPROPERTY_TYPE_SET、KSPROPERTY_TYPE_UNSERIALIZESET 或 KSPROPERTY_TYPE_UNSERIALIZERAW 操作的數據的緩衝區的指針，或接收所有其他操作的數據的緩衝區空間。</param>
        /// <param name="dataLength">PropertyData中緩衝區的大小（以位元組為單位）。</param>
        /// <param name="bytesReturned">指向一個變數的指針，該變數接收KsProperty存儲在PropertyData緩衝區中的數據的大小（以位元組為單位）。如果沒有存儲數據，則大小為零。</param>
        /// <returns></returns>
        [PreserveSig]
        int KsProperty(
            [In] ref KsMethod property,
            [In] int propertyLength,
            [In, Out] IntPtr propertyData,
            [In] int dataLength,
            [In, Out] ref int bytesReturned
        );

        /// <summary>
        /// KsMethod方法向 KS 對象發送一個方法，以及方法集上可用的任何其他定義的支持操作。
        /// </summary>
        /// <param name="method">指向描述方法和方法請求的請求類型的KSMETHOD結構的指針。</param>
        /// <param name="methodLength">Method處緩衝區的大小（以位元組為單位）。</param>
        /// <param name="methodData">指向包含用於 KSMETHOD_TYPE_SEND 操作的數據和緩衝區空間的緩衝區，或用於接收所有其他操作的數據的緩衝區空間的指針。</param>
        /// <param name="dataLength">MethodData緩衝區的大小（以位元組為單位）。</param>
        /// <param name="bytesReturned">指向一個變數的指針，該變數接收KsMethod存儲在MethodData緩衝區中的數據的大小（以位元組為單位）。</param>
        /// <returns></returns>
        [PreserveSig]
        int KsMethod(
            [In] ref KsMethod method,
            [In] int methodLength,
            [In, Out] IntPtr methodData,
            [In] int dataLength,
            [In, Out] ref int bytesReturned
        );

        /// <summary>
        /// KsEvent方法啟用或禁用事件，以及事件集上可用的任何其他定義的支持操作。
        /// </summary>
        /// <param name="method">指向描述事件的KSEVENT結構的指針以啟用該事件，為NULL以禁用該事件。</param>
        /// <param name="eventLength">啟用事件時事件緩衝區的大小（以位元組為單位），禁用事件時為零。</param>
        /// <param name="eventData">指向包含事件數據和接收事件數據的緩衝區空間的KSEVENTDATA結構的指針。</param>
        /// <param name="dataLength">EventData中緩衝區的大小（以位元組為單位）。</param>
        /// <param name="bytesReturned">指向一個變數的指針，該變數接收KsEvent存儲在EventData緩衝區中的數據的大小（以位元組為單位）。</param>
        /// <returns></returns>
        [PreserveSig]
        int KsEvent(
            [In, Optional]  ref KsMethod method,
            [In] int eventLength,
            [In, Out] IntPtr eventData,
            [In] int dataLength,
            [In, Out] ref int bytesReturned
        );
    }

    /// <summary>
    /// 結構指定方法集中的單個內核流方法。
    /// </summary>
    public struct KsMethod
    {
        /// <summary>
        /// 指定標識內核流方法集的 GUID。
        /// </summary>
        public Guid Set;

        /// <summary>
        /// 指定方法集的成員。
        /// </summary>
        public int Id;

        /// <summary>
        /// 
        /// </summary>
        public int Flags;

        /// <summary>
        /// 指定請求類型。
        /// </summary>
        /// <param name="set"></param>
        /// <param name="id"></param>
        /// <param name="flags"></param>
        public KsMethod(Guid set, int id, int flags)
        {
            Set = set;
            Id = id;
            Flags = flags;
        }
    }

    /// <summary>
    /// 
    /// </summary>
    public struct KspNode
    {
        /// <summary>
        /// 
        /// </summary>
        public KsMethod Property;

        /// <summary>
        /// 
        /// </summary>
        public Int32 NodeId;

        /// <summary>
        /// 
        /// </summary>
        public Int32 Reserved;
    }
/// <summary>
    /// UVC擴展介面返回結果
    /// </summary>
    public class DvbResult<T> : DvbResult where T : struct
    {
        /// <summary>
        /// 返回欄位結果對象
        /// </summary>
        public T Data { get; set; } = new T();
    }

    /// <summary>
    /// UVC擴展介面返回結果
    /// </summary>
    public class DvbResult
    {
        /// <summary>
        /// 返回結果
        /// </summary>
        public int Result { get; set; } = -1;
    }

_pControl.KsProperty(ref nod.Property, Marshal.SizeOf(nod), dataPro, dataSize, ref dwReturned);

(T)Marshal.PtrToStructure(dataPro, typeof(T));

對於返回結果對象類型，經常會出現匹配不上，獲取給的位元組大小對應不上，導致獲取的數據不對。所以最好統一使用byte類型或者byte[]類型獲取，然後進一步轉化成需要的類型。

例如：

public struct RectangleAreaDvbData
    {
        public RectangleAreaDvbData(byte[] reserve)
        {
            Reserve = reserve;
        }

        [MarshalAs(UnmanagedType.ByValArray, SizeConst = 8)]
        public byte[] Reserve;
    }

 


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • Java併發小結01
    事務基礎 事務 事務 是一組操作的集合，它是一個不可分割的工作單位，事務會把所有的操作作為一個整體一起向系統提交或撤銷操作請求，即這些操作要麼同時成功，要麼同時失敗。 特性 原子性（Atomicity）：事務是不可分割的最小操作單元，要麼全部成功，要麼全部失敗。 一致性（Consistency）：事 ...
  • Spring筆記_mybatis
    mybatis 使用資料庫連接池初始化連接資源 將sql語句抽取到xml配置文件中 使用反射、內省等底層技術，自動將實體與表進行屬性與欄位的自動映射 介紹 mybatis 是一個優秀的基於java的持久層框架，它內部封裝了jdbc，使開發者只需要關註sql語句本身，而不需要花費精力去處理載入驅動、創 ...
  • Python+ChatGPT製作一個AI實用百寶箱
    ChatGPT 最近在互聯網掀起了一陣熱潮，其高度智能化的功能能夠給我們現實生活帶來諸多的便利，可以幫助你寫文章、寫報告、寫周報、做表格、做策劃甚至還會寫代碼。只要與文字相關的工作，它幾乎都能給出一份滿意的答卷。 一、註冊OpenAI 首先需要註冊OpenAI，這樣就可以使用ChatGPT 二、搭建 ...
  • Visual Studio 2022 安裝.NET Framework4.5及以下目標包
    簡介 官方定義：MessagePack是一種高效的二進位序列化格式。它允許您像JSON一樣在多個語言之間交換數據。但是它更快並且更小。 MessagePack是一種開源的序列化反序列化組件，可支持JAVA，C#等主流語言。在 C# 中使用 MessagePack，需要添加 MessagePack-C ...
  • svn提交規範
    本文檔參考了Git提交規範，旨在規範使用SVN進行代碼版本管理時的提交操作。 提交前的準備 1. 檢查代碼 在提交代碼前，請先進行必要的代碼檢查，確保代碼的正確性、可讀性和可維護性。可以使用代碼質量管理工具進行自動化檢查，也可以手動檢查。 2. 編寫提交信息 在提交代碼時，需要編寫提交信息來描述本次 ...
  • 精準地測量時間
    Stopwatch ...
  • WPF學習筆記06-依賴屬性DependencyProperty
    在學習依賴屬性之前，我們首先要知道屬性是什麼？屬性呢其實就是為了保護數據！避免數據直接暴漏給外界。什麼是依賴屬性呢？依賴屬性和屬性又有什麼區別呢？依賴屬性是一種可以自己沒有值，並能通過使用Binding從數據源獲得值的屬性。言簡意賅，就是依靠著別人賦值的屬性。至於區別是什麼，我們接下來說完依賴屬性之 ...
  • 記一次 .NET某汽車零件採集系統 卡死分析
    一：背景 1. 講故事 前段時間有位朋友在微信上找到我，說他的程式會出現一些偶發卡死的情況，讓我幫忙看下是怎麼回事，剛好朋友也抓到了dump，就讓朋友把 dump 丟給我，接下來用 windbg 探究下到底咋回事。 二：WinDbg 分析 1. 程式真的卡死嗎 因為是一個 winform 程式，驗證 ...
一周排行
    -Advertisement-
    Play Games
  • （開源）都進來！簡單易懂、功能強大的許可權+可視化流程管理系統
    1、預覽地址：http://139.155.137.144:9012 2、qq群:801913255 一、前言 隨著網路的發展，企業對於信息系統數據的保密工作愈發重視，不同身份、角色對於數據的訪問許可權都應該大相徑庭。 列如 1、不同登錄人員對一個數據列表的可見度是不一樣的，如數據列、數據行、數據按鈕 ...
  • 設計模式-C#實現簡單工廠模式
    前言 上一篇文章寫瞭如何使用RabbitMQ做個簡單的發送郵件項目，然後評論也是比較多，也是準備去學習一下如何確保RabbitMQ的消息可靠性，但是由於時間原因，先來說說設計模式中的簡單工廠模式吧！ 在瞭解簡單工廠模式之前，我們要知道C#是一款面向對象的高級程式語言。它有3大特性，封裝、繼承、多態。 ...
  • Nodify學習 一：介紹與使用
    Nodify學習 一：介紹與使用 - 可樂_加冰 - 博客園 (cnblogs.com) Nodify學習 二：添加節點 - 可樂_加冰 - 博客園 (cnblogs.com) 介紹 Nodify是一個WPF基於節點的編輯器控制項，其中包含一系列節點、連接和連接器組件，旨在簡化構建基於節點的工具的過程 ...
  • 使用C#/.NET解析Wiki百科數據實現獲取歷史上的今天
    創建一個webapi項目做測試使用。 創建新控制器，搭建一個基礎框架，包括獲取當天日期、wiki的請求地址等 創建一個Http請求幫助類以及方法，用於獲取指定URL的信息 使用http請求訪問指定url，先運行一下，看看返回的內容。內容如圖右邊所示，實際上是一個Json數據。我們主要解析 大事記 部 ...
  • .NET科普：.NET簡史、.NET Standard以及C#和.NET Framework之間的關係
    最近在不少自媒體上看到有關.NET與C#的資訊與評價，感覺大家對.NET與C#還是不太瞭解，尤其是對2016年6月發佈的跨平臺.NET Core 1.0，更是知之甚少。在考慮一番之後，還是決定寫點東西總結一下，也回顧一下.NET的發展歷史。 首先，你沒看錯，.NET是跨平臺的，可以在Windows、 ...
  • Nodify學習 二：添加節點
    Nodify學習 一：介紹與使用 - 可樂_加冰 - 博客園 (cnblogs.com) Nodify學習 二：添加節點 - 可樂_加冰 - 博客園 (cnblogs.com) 添加節點（nodes） 通過上一篇我們已經創建好了編輯器實例現在我們為編輯器添加一個節點 添加model和viewmode ...
  • 論如何直接用EF Core實現創建更新時間、用戶審計，自動化樂觀併發、軟刪除和樹形查詢（上）
    前言 資料庫併發，數據審計和軟刪除一直是數據持久化方面的經典問題。早些時候，這些工作需要手寫複雜的SQL或者通過存儲過程和觸發器實現。手寫複雜SQL對軟體可維護性構成了相當大的挑戰，隨著SQL字數的變多，用到的嵌套和複雜語法增加，可讀性和可維護性的難度是幾何級暴漲。因此如何在實現功能的同時控制這些S ...
  • C# 使用模式匹配的好處,因為好用所以推薦~
    類型檢查和轉換：當你需要檢查對象是否為特定類型，並且希望在同一時間內將其轉換為那個類型時，模式匹配提供了一種更簡潔的方式來完成這一任務，避免了使用傳統的as和is操作符後還需要進行額外的null檢查。 複雜條件邏輯：在處理複雜的條件邏輯時，特別是涉及到多個條件和類型的情況下，使用模式匹配可以使代碼更 ...
  • 推薦一種批量判斷文件是否存在的快速辦法
    在日常開發中，我們經常需要和文件打交道，特別是桌面開發，有時候就會需要載入大批量的文件，而且可能還會存在部分文件缺失的情況，那麼如何才能快速的判斷文件是否存在呢？如果處理不當的，且文件數量比較多的時候，可能會造成卡頓等情況，進而影響程式的使用體驗。今天就以一個簡單的小例子，簡述兩種不同的判斷文件是否... ...
  • 論如何直接用EF Core實現創建更新時間、用戶審計，自動化樂觀併發、軟刪除和樹形查詢（中）
    前言 資料庫併發，數據審計和軟刪除一直是數據持久化方面的經典問題。早些時候，這些工作需要手寫複雜的SQL或者通過存儲過程和觸發器實現。手寫複雜SQL對軟體可維護性構成了相當大的挑戰，隨著SQL字數的變多，用到的嵌套和複雜語法增加，可讀性和可維護性的難度是幾何級暴漲。因此如何在實現功能的同時控制這些S ...
所有分類