1# camera_input.h
2
3
4## Overview
5
6The **camera_input.h** file declares the camera input concepts.
7
8**Library**: libohcamera.so
9
10**File to include**: <ohcamera/camera_input.h>
11
12**System capability**: SystemCapability.Multimedia.Camera.Core
13
14**Since**: 11
15
16**Related module**: [OH_Camera](_o_h___camera.md)
17
18
19## Summary
20
21
22### Structs
23
24| Name| Description|
25| -------- | -------- |
26| struct  [CameraInput_Callbacks](_camera_input___callbacks.md) | Describes the callbacks used to listen for camera input errors. |
27
28
29### Types
30
31| Name| Description|
32| -------- | -------- |
33| typedef struct [Camera_Input](_o_h___camera.md#camera_input) [Camera_Input](_o_h___camera.md#camera_input) | Defines a struct for the camera input object. |
34| typedef void(\* [OH_CameraInput_OnError](_o_h___camera.md#oh_camerainput_onerror)) (const [Camera_Input](_o_h___camera.md#camera_input) \*cameraInput, [Camera_ErrorCode](_o_h___camera.md#camera_errorcode) errorCode) | Defines the pointer to the callback defined in the [CameraInput_Callbacks](_camera_input___callbacks.md) struct and used to report camera input errors. |
35| typedef struct [CameraInput_Callbacks](_camera_input___callbacks.md) [CameraInput_Callbacks](_o_h___camera.md#camerainput_callbacks) | Defines a struct for the callbacks used to listen for camera input errors. |
36
37
38### Functions
39
40| Name| Description|
41| -------- | -------- |
42| [Camera_ErrorCode](_o_h___camera.md#camera_errorcode) [OH_CameraInput_RegisterCallback](_o_h___camera.md#oh_camerainput_registercallback) ([Camera_Input](_o_h___camera.md#camera_input) \*cameraInput, [CameraInput_Callbacks](_camera_input___callbacks.md) \*callback) | Registers a callback to listen for camera input events. |
43| [Camera_ErrorCode](_o_h___camera.md#camera_errorcode) [OH_CameraInput_UnregisterCallback](_o_h___camera.md#oh_camerainput_unregistercallback) ([Camera_Input](_o_h___camera.md#camera_input) \*cameraInput, [CameraInput_Callbacks](_camera_input___callbacks.md) \*callback) | Unregisters the callback used to listen for camera input events. |
44| [Camera_ErrorCode](_o_h___camera.md#camera_errorcode) [OH_CameraInput_Open](_o_h___camera.md#oh_camerainput_open) ([Camera_Input](_o_h___camera.md#camera_input) \*cameraInput) | Opens a camera. |
45| [Camera_ErrorCode](_o_h___camera.md#camera_errorcode) [OH_CameraInput_OpenSecureCamera](_o_h___camera.md#oh_camerainput_opensecurecamera) ([Camera_Input](_o_h___camera.md#camera_input) \*cameraInput, uint64_t \*secureSeqId) | Opens a camera in secure mode. |
46| [Camera_ErrorCode](_o_h___camera.md#camera_errorcode) [OH_CameraInput_Close](_o_h___camera.md#oh_camerainput_close) ([Camera_Input](_o_h___camera.md#camera_input) \*cameraInput) | Closes a camera. |
47| [Camera_ErrorCode](_o_h___camera.md#camera_errorcode) [OH_CameraInput_Release](_o_h___camera.md#oh_camerainput_release) ([Camera_Input](_o_h___camera.md#camera_input) \*cameraInput) | Releases a **CameraInput** instance. Either this function or [OH_CameraInput_Close](_o_h___camera.md#oh_camerainput_close) needs to be called. |
48