2.1 EDSDK 的功能概述（Functions of EDSDK）
markdown
## 2.1 EDSDK 的功能概述（Functions of EDSDK）
EDSDK 主要提供以下功能：
markdown
- 连接并控制 Canon 数码相机
- 控制相机的拍摄操作
- 设置和获取相机属性
- 获取相机状态
- 下载相机中保存的图像文件
- 接收并处理来自相机的事件通知2.2 远程连接协议（Remote Connection Protocol）
markdown
## 2.2 远程连接协议（Remote Connection Protocol）EDSDK 使用 PTP（Picture Transfer Protocol，图片传输协议） 与相机进行通信。
markdown
- PTP 是一种标准化的图像设备通信协议
- Canon 在标准 PTP 的基础上扩展了专有命令
- EDSDK 封装了这些 Canon 扩展命令，供应用程序调用通过 EDSDK，开发者无需直接实现 PTP 协议，即可控制相机并访问其数据。
2.3 系统结构（System Architecture）
markdown
## 2.3 系统结构（System Architecture）EDSDK 系统结构由以下组件构成：
markdown
- 应用程序（Client Application）
- EDSDK 库
- 操作系统的设备驱动
- Canon 数码相机工作流程说明
markdown
1. 应用程序调用 EDSDK API
2. EDSDK 将 API 请求转换为相机可识别的命令
3. 命令通过操作系统和设备驱动发送至相机
4. 相机返回结果
5. EDSDK 将结果转换为 API 返回值并返回给应用程序2.4 EDSDK 的对象模型（Object Model）
markdown
## 2.4 EDSDK 的对象模型（Object Model）EDSDK 采用 对象模型（Object-Oriented Model） 来表示相机及其资源。
markdown
EDSDK 中的所有资源都以"对象"的形式进行管理，
并通过句柄（Handle）在应用程序中进行访问。主要对象类型
markdown
- 相机对象（Camera）
- 卷对象（Volume）
- 文件夹对象（Directory）
- 文件对象（File）
- 流对象（Stream）所有对象都继承自 EdsBaseRef 类型。
2.5 会话管理（Session Management）
markdown
## 2.5 会话管理（Session Management）在使用 EDSDK 控制相机之前，必须先打开一个 会话（Session）。
markdown
基本流程如下：
1. 获取相机对象
2. 调用 `EdsOpenSession` 打开会话
3. 通过会话控制相机
4. 调用 `EdsCloseSession` 关闭会话注意：
- 同一时间只能有一个会话与相机保持连接
- 如果会话未正确关闭，可能导致相机无法再次连接
2.6 事件处理（Event Handling）
markdown
## 2.6 事件处理（Event Handling）EDSDK 提供了事件通知机制，用于通知应用程序相机状态的变化。
事件类型
markdown
- 对象事件（Object Event）
- 属性事件（Property Event）
- 状态事件（State Event）事件处理方式
markdown
- 应用程序需要注册回调函数
- 当事件发生时，EDSDK 会调用对应的回调函数
- 应用程序在回调中处理相应逻辑2.7 错误处理（Error Handling）
markdown
## 2.7 错误处理（Error Handling）EDSDK 的所有 API 都会返回一个 错误码（EdsError）。
markdown
- 返回值为 `EDS_ERR_OK` 表示调用成功
- 其他返回值表示发生错误应用程序必须检查每一次 API 调用的返回值，以确保程序的稳定性。