海康摄像头开发---标准配置结构体（NET_DVR_STD_CONFIG）

NET_DVR_STD_CONFIG 是海康威视SDK（网络硬盘录像机开发工具包）中定义的一个标准配置结构体 ，主要用于在调用设备配置相关接口（如 NET_DVR_SetSTDConfig 配置参数、NET_DVR_GetSTDConfig 读取参数）时，作为数据载体传递或接收具体的配置信息。它是SDK中处理设备各类标准配置的"通用容器"，统一了不同配置项的交互格式。

一、结构体的核心作用

海康设备（如摄像头、抓拍机）有大量可配置的参数（如补光灯参数、网络参数、编码参数、报警参数等），每种参数都有其专属的结构体（例如补光灯用 NET_DVR_BUILTIN_SUPPLEMENTLIGHT，网络参数用 NET_DVR_NETCFG_V40 等）。

NET_DVR_STD_CONFIG 的作用是：将这些"具体参数结构体"包装成统一格式 ，使得SDK的配置接口（NET_DVR_SetSTDConfig/NET_DVR_GetSTDConfig）可以通用化处理所有类型的配置，而无需为每种参数单独设计接口。

二、结构体的成员组成（基于SDK文档）

NET_DVR_STD_CONFIG 的成员变量通常包含以下核心字段（不同SDK版本可能略有差异，但核心逻辑一致）：

typedef struct {
    LPVOID lpInBuffer;       // 输入缓冲区：指向具体的配置参数结构体（设置参数时使用）
    DWORD  dwInSize;         // 输入缓冲区大小：具体配置结构体的字节数（设置参数时使用）
    LPVOID lpOutBuffer;      // 输出缓冲区：用于接收设备返回的配置参数（读取参数时使用）
    DWORD  dwOutSize;        // 输出缓冲区大小：预分配的输出缓冲区字节数（读取参数时使用）
    LPDWORD lpdwReturnedSize;// 实际返回大小：设备返回的配置数据实际字节数（读取参数时使用）
} NET_DVR_STD_CONFIG;

每个成员的详细含义：

1. lpInBuffer

   • 类型：LPVOID（通用指针，可指向任意类型的结构体）
   • 作用：设置参数时，指向具体的配置结构体（如补光灯配置 NET_DVR_BUILTIN_SUPPLEMENTLIGHT、网络配置 NET_DVR_NETCFG_V40 等），告诉SDK"要配置的具体内容"。
   • 示例：在 light_on() 方法中，lpInBuffer 指向补光灯配置结构体 supplementlight_config。

2. dwInSize

   • 类型：DWORD（无符号整数）
   • 作用：设置参数时，指定 lpInBuffer 指向的具体配置结构体的大小（字节数），确保SDK能正确解析输入数据。
   • 示例：dwInSize = sizeof(NET_DVR_BUILTIN_SUPPLEMENTLIGHT) 表示输入是补光灯结构体的大小。

3. lpOutBuffer

   • 类型：LPVOID
   • 作用：读取参数时，指向一个预分配的缓冲区（通常是与配置类型对应的结构体），用于接收设备返回的当前配置数据。
   • 示例：若要读取补光灯当前参数，需先创建 NET_DVR_BUILTIN_SUPPLEMENTLIGHT 结构体，再让 lpOutBuffer 指向它。

4. dwOutSize

   • 类型：DWORD
   • 作用：读取参数时，指定 lpOutBuffer 缓冲区的大小（字节数），确保缓冲区足够容纳设备返回的数据（避免溢出）。

5. lpdwReturnedSize

   • 类型：LPDWORD（指向无符号整数的指针）
   • 作用：读取参数时，用于接收设备实际返回的配置数据大小（可能小于 dwOutSize），便于验证数据完整性。

三、典型使用场景

NET_DVR_STD_CONFIG 几乎用于所有设备"标准配置"的读写操作，以下是两类核心场景：

1. 设置设备参数（调用 NET_DVR_SetSTDConfig）

流程：

① 定义具体配置类型的结构体（如补光灯、网络参数）；

② 初始化 NET_DVR_STD_CONFIG，将 lpInBuffer 指向具体结构体，dwInSize 设为结构体大小；

③ 调用 NET_DVR_SetSTDConfig 接口，传入设备登录ID、配置类型标识、NET_DVR_STD_CONFIG 指针。

示例（对应 light_on() 方法的补光灯配置）：

// 1. 定义具体配置结构体（补光灯参数）
NET_DVR_BUILTIN_SUPPLEMENTLIGHT light_cfg;
memset(&light_cfg, 0, sizeof(light_cfg));
light_cfg.byMixedLightRegulatMode = 1; // 手动调节模式
light_cfg.byWhiteLightBrightness = 2;  // 亮度等级2

// 2. 初始化标准配置结构体（包装具体配置）
NET_DVR_STD_CONFIG std_cfg;
memset(&std_cfg, 0, sizeof(std_cfg));
std_cfg.lpInBuffer = &light_cfg;       // 指向补光灯配置
std_cfg.dwInSize = sizeof(light_cfg);  // 补光灯结构体大小

// 3. 调用接口设置参数（NET_DVR_SET_SUPPLEMENTLIGHT是补光灯配置的类型标识）
NET_DVR_SetSTDConfig(_user_id, NET_DVR_SET_SUPPLEMENTLIGHT, &std_cfg);

2. 读取设备参数（调用 NET_DVR_GetSTDConfig）

流程：

① 定义具体配置类型的结构体（用于接收数据）；

② 初始化 NET_DVR_STD_CONFIG，将 lpOutBuffer 指向该结构体，dwOutSize 设为结构体大小；

③ 调用 NET_DVR_GetSTDConfig 接口，传入设备登录ID、配置类型标识、NET_DVR_STD_CONFIG 指针；

④ 从 lpOutBuffer 指向的结构体中获取设备当前配置。

示例（读取补光灯当前参数）：

// 1. 定义具体配置结构体（用于接收数据）
NET_DVR_BUILTIN_SUPPLEMENTLIGHT light_cfg;
memset(&light_cfg, 0, sizeof(light_cfg));

// 2. 初始化标准配置结构体（指定输出缓冲区）
NET_DVR_STD_CONFIG std_cfg;
memset(&std_cfg, 0, sizeof(std_cfg));
std_cfg.lpOutBuffer = &light_cfg;      // 指向接收缓冲区
std_cfg.dwOutSize = sizeof(light_cfg); // 缓冲区大小
DWORD actual_size;
std_cfg.lpdwReturnedSize = &actual_size; // 接收实际返回大小

// 3. 调用接口读取参数
if (NET_DVR_GetSTDConfig(_user_id, NET_DVR_GET_SUPPLEMENTLIGHT, &std_cfg)) {
    // 4. 读取成功，从light_cfg中获取当前配置
    qDebug() << "当前亮度等级：" << light_cfg.byWhiteLightBrightness;
}

四、关键注意事项

1. 配置类型标识必须匹配

   调用 NET_DVR_SetSTDConfig/NET_DVR_GetSTDConfig 时，第二个参数是"配置类型标识"（如 NET_DVR_SET_SUPPLEMENTLIGHT 表示补光灯配置，NET_DVR_SET_NETCFG 表示网络配置），必须与 lpInBuffer/lpOutBuffer 指向的具体结构体类型严格匹配，否则会导致配置失败或数据错误。

2. 缓冲区大小必须正确

   • dwInSize 必须等于 lpInBuffer 指向的结构体实际大小；
   • dwOutSize 必须大于等于设备返回数据的实际大小（通常设为对应结构体的大小），否则可能导致数据截断或内存溢出。

3. 初始化清零

   使用前必须通过 memset 将 NET_DVR_STD_CONFIG 及具体配置结构体清零，避免未初始化的垃圾值干扰配置。

4. 依赖有效登录

   调用配置接口时，_user_id（设备登录ID）必须有效（>=0），否则会因"未登录设备"导致失败。

---

NET_DVR_STD_CONFIG 是海康SDK中"配置参数交互"的核心结构体，它通过统一的格式包装了各种具体配置参数（补光灯、网络、编码等），使得SDK可以用通用接口（NET_DVR_SetSTDConfig/NET_DVR_GetSTDConfig）处理所有类型的配置操作，简化了开发流程。