1# image_receiver_native.h 2 3 4## Overview 5 6The **image_receiver_native.h** file declares the APIs used to obtain image data from the native layer. 7 8**Library**: libimage_receiver.so 9 10**System capability**: SystemCapability.Multimedia.Image.ImageReceiver 11 12**Since**: 12 13 14**Related module**: [Image_NativeModule](_image___native_module.md) 15 16 17## Summary 18 19 20### Types 21 22| Name| Description| 23| -------- | -------- | 24| typedef struct [OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) [OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) | Defines the data type name of the image receiver at the native layer. | 25| typedef struct [OH_ImageReceiverOptions](_image___native_module.md#oh_imagereceiveroptions) [OH_ImageReceiverOptions](_image___native_module.md#oh_imagereceiveroptions) | Defines the data type name of the image receiver options. | 26| typedef void(\* [OH_ImageReceiver_OnCallback](_image___native_module.md#oh_imagereceiver_oncallback)) ([OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) \*receiver) | Defines the callbacks for the image receiver at the native layer. | 27 28 29### Functions 30 31| Name| Description| 32| -------- | -------- | 33| [Image_ErrorCode](_image___native_module.md#image_errorcode) [OH_ImageReceiverOptions_Create](_image___native_module.md#oh_imagereceiveroptions_create) ([OH_ImageReceiverOptions](_image___native_module.md#oh_imagereceiveroptions) \*\*options) | Creates an **OH_ImageReceiverOptions** object at the application layer. | 34| [Image_ErrorCode](_image___native_module.md#image_errorcode) [OH_ImageReceiverOptions_GetSize](_image___native_module.md#oh_imagereceiveroptions_getsize) ([OH_ImageReceiverOptions](_image___native_module.md#oh_imagereceiveroptions) \*options, [Image_Size](_image___size.md) \*size) | Obtains the [Image_Size](_image___size.md) information of an [OH_ImageReceiverOptions](_image___native_module.md#oh_imagereceiveroptions) object. | 35| [Image_ErrorCode](_image___native_module.md#image_errorcode) [OH_ImageReceiverOptions_SetSize](_image___native_module.md#oh_imagereceiveroptions_setsize) ([OH_ImageReceiverOptions](_image___native_module.md#oh_imagereceiveroptions) \*options, [Image_Size](_image___size.md) size) | Sets the [Image_Size](_image___size.md) information for an [OH_ImageReceiverOptions](_image___native_module.md#oh_imagereceiveroptions) object. | 36| [Image_ErrorCode](_image___native_module.md#image_errorcode) [OH_ImageReceiverOptions_GetCapacity](_image___native_module.md#oh_imagereceiveroptions_getcapacity) ([OH_ImageReceiverOptions](_image___native_module.md#oh_imagereceiveroptions) \*options, int32_t \*capacity) | Obtains the capacity of an [OH_ImageReceiverOptions](_image___native_module.md#oh_imagereceiveroptions) object. | 37| [Image_ErrorCode](_image___native_module.md#image_errorcode) [OH_ImageReceiverOptions_SetCapacity](_image___native_module.md#oh_imagereceiveroptions_setcapacity) ([OH_ImageReceiverOptions](_image___native_module.md#oh_imagereceiveroptions) \*options, int32_t capacity) | Sets the capacity for an [OH_ImageReceiverOptions](_image___native_module.md#oh_imagereceiveroptions) object. | 38| [Image_ErrorCode](_image___native_module.md#image_errorcode) [OH_ImageReceiverOptions_Release](_image___native_module.md#oh_imagereceiveroptions_release) ([OH_ImageReceiverOptions](_image___native_module.md#oh_imagereceiveroptions) \*options) | Releases an [OH_ImageReceiverOptions](_image___native_module.md#oh_imagereceiveroptions) object. | 39| [Image_ErrorCode](_image___native_module.md#image_errorcode) [OH_ImageReceiverNative_Create](_image___native_module.md#oh_imagereceivernative_create) ([OH_ImageReceiverOptions](_image___native_module.md#oh_imagereceiveroptions) \*options, [OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) \*\*receiver) | Creates an **OH_ImageReceiverNative** object at the application layer. | 40| [Image_ErrorCode](_image___native_module.md#image_errorcode) [OH_ImageReceiverNative_GetReceivingSurfaceId](_image___native_module.md#oh_imagereceivernative_getreceivingsurfaceid) ([OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) \*receiver, uint64_t \*surfaceId) | Obtains the receiver ID through an [OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) object. | 41| [Image_ErrorCode](_image___native_module.md#image_errorcode) [OH_ImageReceiverNative_ReadLatestImage](_image___native_module.md#oh_imagereceivernative_readlatestimage) ([OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) \*receiver, [OH_ImageNative](_image___native_module.md#oh_imagenative) \*\*image) | Obtains the latest image through an [OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) object. | 42| [Image_ErrorCode](_image___native_module.md#image_errorcode) [OH_ImageReceiverNative_ReadNextImage](_image___native_module.md#oh_imagereceivernative_readnextimage) ([OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) \*receiver, [OH_ImageNative](_image___native_module.md#oh_imagenative) \*\*image) | Obtains the next image through an [OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) object. | 43| [Image_ErrorCode](_image___native_module.md#image_errorcode) [OH_ImageReceiverNative_On](_image___native_module.md#oh_imagereceivernative_on) ([OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) \*receiver, [OH_ImageReceiver_OnCallback](_image___native_module.md#oh_imagereceiver_oncallback) callback) | Registers a callback, which is an [OH_ImageReceiver_OnCallback](_image___native_module.md#oh_imagereceiver_oncallback) object. | 44| [Image_ErrorCode](_image___native_module.md#image_errorcode) [OH_ImageReceiverNative_Off](_image___native_module.md#oh_imagereceivernative_off) ([OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) \*receiver) | Unregisters a callback, which is an [OH_ImageReceiver_OnCallback](_image___native_module.md#oh_imagereceiver_oncallback) object. | 45| [Image_ErrorCode](_image___native_module.md#image_errorcode) [OH_ImageReceiverNative_GetSize](_image___native_module.md#oh_imagereceivernative_getsize) ([OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) \*receiver, [Image_Size](_image___size.md) \*size) | Obtains the size of an image receiver, which is an [OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) object. | 46| [Image_ErrorCode](_image___native_module.md#image_errorcode) [OH_ImageReceiverNative_GetCapacity](_image___native_module.md#oh_imagereceivernative_getcapacity) ([OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) \*receiver, int32_t \*capacity) | Obtains the capacity of an image receiver, which is an [OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) object. | 47| [Image_ErrorCode](_image___native_module.md#image_errorcode) [OH_ImageReceiverNative_Release](_image___native_module.md#oh_imagereceivernative_release) ([OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) \*receiver) | Releases an [OH_ImageReceiverNative](_image___native_module.md#oh_imagereceivernative) object. | 48