1# IDCameraProviderCallback
2
3
4## 概述
5
6定义Distributed Camera设备功能回调操作。
7
8对Distributed Camera设备执行创建通道，创建流，捕获图像和更新设置等操作。
9
10**起始版本：** 3.2
11
12**相关模块：**[Camera](_distributed.md)
13
14
15## 汇总
16
17
18### Public 成员函数
19
20| 名称 | 描述 |
21| -------- | -------- |
22| [OpenSession](#opensession) ([in] struct [DHBase](_d_h_base.md) dhBase) | 在源设备和目的设备之间创建传输通道。打开并初始化分布式相机会话。  |
23| [CloseSession](#closesession) ([in] struct [DHBase](_d_h_base.md) dhBase) | 关闭分布式相机会话，并销毁源设备和目的设备之间的传输通道。  |
24| [ConfigureStreams](#configurestreams) ([in] struct [DHBase](_d_h_base.md) dhBase,[in] struct [DCStreamInfo](_d_c_stream_info.md)[] streamInfos) | 配置流。  |
25| [ReleaseStreams](#releasestreams) ([in] struct [DHBase](_d_h_base.md) dhBase,[in] int[] streamIds) | 释放流。  |
26| [StartCapture](#startcapture) ([in] struct [DHBase](_d_h_base.md) dhBase,[in] struct [DCCaptureInfo](_d_c_capture_info.md)[] captureInfos) | 开始捕获图像。  |
27| [StopCapture](#stopcapture) ([in] struct [DHBase](_d_h_base.md) dhBase,[in] int[] streamIds) | 停止捕获图像。  |
28| [UpdateSettings](#updatesettings) ([in] struct [DHBase](_d_h_base.md) dhBase,[in] struct [DCameraSettings](_d_camera_settings.md)[] settings) | 更新设备控制参数。  |
29
30
31## 成员函数说明
32
33
34### CloseSession()
35
36```
37IDCameraProviderCallback::CloseSession ([in] struct DHBase dhBase)
38```
39**描述**
40
41关闭分布式相机会话，并销毁源设备和目的设备之间的传输通道。
42
43**起始版本：** 3.2
44
45**参数:**
46
47| 名称 | 描述 |
48| -------- | -------- |
49| dhBase | 分布式相机设备基础信息。 |
50
51**返回：**
52
53NO_ERROR 表示执行成功。
54
55其他值表示执行失败，具体错误码查看[DCamRetCode](_distributed.md#dcamretcode)。
56
57
58### ConfigureStreams()
59
60```
61IDCameraProviderCallback::ConfigureStreams ([in] struct DHBase dhBase, [in] struct DCStreamInfo[] streamInfos )
62```
63**描述**
64
65配置流。
66
67**起始版本：** 3.2
68
69**参数:**
70
71| 名称 | 描述 |
72| -------- | -------- |
73| dhBase | 分布式相机设备基础信息。  |
74| streamInfos | 流信息列表，流信息定义在[DCStreamInfo](_d_c_stream_info.md)。 |
75
76**返回：**
77
78NO_ERROR 表示执行成功。
79
80其他值表示执行失败，具体错误码查看[DCamRetCode](_distributed.md#dcamretcode)。
81
82
83### OpenSession()
84
85```
86IDCameraProviderCallback::OpenSession ([in] struct DHBase dhBase)
87```
88**描述**
89
90在源设备和目的设备之间创建传输通道。打开并初始化分布式相机会话。
91
92**起始版本：** 3.2
93
94**参数:**
95
96| 名称 | 描述 |
97| -------- | -------- |
98| dhBase | 分布式相机设备基础信息。 |
99
100**返回：**
101
102NO_ERROR 表示执行成功。
103
104其他值表示执行失败，具体错误码查看[DCamRetCode](_distributed.md#dcamretcode)。
105
106
107### ReleaseStreams()
108
109```
110IDCameraProviderCallback::ReleaseStreams ([in] struct DHBase dhBase, [in] int[] streamIds )
111```
112**描述**
113
114释放流。
115
116**起始版本：** 3.2
117
118**参数:**
119
120| 名称 | 描述 |
121| -------- | -------- |
122| dhBase | 分布式相机设备基础信息。  |
123| streamIds | 要释放的流ID列表。 |
124
125**返回：**
126
127NO_ERROR 表示执行成功。
128
129其他值表示执行失败，具体错误码查看[DCamRetCode](_distributed.md#dcamretcode)。
130
131
132### StartCapture()
133
134```
135IDCameraProviderCallback::StartCapture ([in] struct DHBase dhBase, [in] struct DCCaptureInfo[] captureInfos )
136```
137**描述**
138
139开始捕获图像。
140
141本接口必须在调用**ConfigStreams**配置流之后调用。 图像捕获有两种模式，分别是连续捕获和单次捕获。
142
143**起始版本：** 3.2
144
145**参数:**
146
147| 名称 | 描述 |
148| -------- | -------- |
149| dhBase | 分布式相机设备基础信息。  |
150| captureInfos | 捕获请求的参数信息，具体信息查看[DCCaptureInfo](_d_c_capture_info.md)。 |
151
152**返回：**
153
154NO_ERROR 表示执行成功。
155
156其他值表示执行失败，具体错误码查看[DCamRetCode](_distributed.md#dcamretcode)。
157
158
159### StopCapture()
160
161```
162IDCameraProviderCallback::StopCapture ([in] struct DHBase dhBase, [in] int[] streamIds )
163```
164**描述**
165
166停止捕获图像。
167
168**起始版本：** 3.2
169
170**参数:**
171
172| 名称 | 描述 |
173| -------- | -------- |
174| dhBase | 分布式相机设备基础信息。 |
175
176**返回：**
177
178NO_ERROR 表示执行成功。
179
180其他值表示执行失败，具体错误码查看[DCamRetCode](_distributed.md#dcamretcode)。
181
182
183### UpdateSettings()
184
185```
186IDCameraProviderCallback::UpdateSettings ([in] struct DHBase dhBase, [in] struct DCameraSettings[] settings )
187```
188**描述**
189
190更新设备控制参数。
191
192**起始版本：** 3.2
193
194**参数:**
195
196| 名称 | 描述 |
197| -------- | -------- |
198| dhBase | 分布式相机设备基础信息。 |
199| settings | 设置参数，包括sensor帧率，3A相关参数等。具体信息查看[DCameraSettings](_d_camera_settings.md)。 |
200
201**返回：**
202
203NO_ERROR 表示执行成功。
204
205其他值表示执行失败，具体错误码查看[DCamRetCode](_distributed.md#dcamretcode)。
206