Monitoring

SetMonitoringDeliverySetting

Overview

Set the streaming destination host PC information on the camera.

Definition

CrError SetMonitoringDeliverySetting(CrDeviceHandle deviceHandle, CrMonitoringDeliverySetting* deliverySetting, CrInt32u numOfSetting);

Input parameters

Type	Explanation
CrDeviceHandle	deviceHandle
CrMonitoringDeliverySetting*	deliverySetting This parameter points to the CrMonitoringDeliverySetting object which contains the monitoring setting that will be set to the device.
CrInt32u	numOfSetting 1 fixed. In version 1.11.00, multiple information cannot be set.

Output parameters

None

Return value

Type	Explanation
CrError	CrError_None on Success Other than errors above, see Status code & Error

Related API

• GetMonitoringDeliverySetting

• ControlMonitoring

• IDeviceCallback::OnWarning

Special note (details)

This API can be executed when CrDeviceProperty_MonitoringSettingVersion exists and CrDeviceProperty_MonitoringSettingVersion is CrEnableValue_DisplayOnly.

GetMonitoringDeliverySetting

Overview

Get the information of the destination host PC set with SetMonitoringDeliverySetting().

Definition

CrError GetMonitoringDeliverySetting(CrDeviceHandle deviceHandle, CrMonitoringDeliverySetting** deliverySetting, CrInt32u* numOfSetting);

Input parameters

Type	Explanation
CrDeviceHandle	deviceHandle

Output parameters

Type	Explanation
CrMonitoringDeliverySetting**	deliverySetting The CrMonitoringDeliverySetting list pointer. Developers should pass the address of a modifiable CrMonitoringDeliverySetting pointer. The value of this pointer should be initialized to nullptr. Copy the Monitoring setting information stored inside the SDK-internal after the success of SetMonitoringDeliverySetting() to this pointer.
CrInt32u*	numOfSetting An integer pointer that indicates the number of CrMonitoringDeliverySetting returned by the list pointer. Developers should pass the address of a modifiable CrInt32u variable.

Return value

Type	Explanation
CrError	CrError_None on Success CrError_Api_NoApplicableInformation SetMonitoringDeliverySetting() may not have been executed.

Related API

• SetMonitoringDeliverySetting

• ReleaseMonitoringDeliverySetting

• IDeviceCallback::OnWarning

Special note (details)

None in particular

ReleaseMonitoringDeliverySetting

Overview

This function releases the CrMonitoringDeliverySetting allocated by GetMonitoringDeliverySetting().

Definition

CrError ReleaseMonitoringDeliverySetting(CrDeviceHandle deviceHandle, CrMonitoringDeliverySetting* deliverySetting);

Input parameters

Type	Explanation
CrDeviceHandle	deviceHandle
CrMonitoringDeliverySetting*	deliverySetting CrMonitoringDeliverySetting list pointer to release.

Output parameters

None

Return value

Type	Explanation
CrError	CrError_None If the list is released successfully CrError_Init if the SDK is uninitialized CrError_Generic_InvalidHandle If the deviceHandle is an invalid handle Other than errors above, see Status code & Error

Related API

• GetMonitoringDeliverySetting

Special note (details)

None in particular

ControlMonitoring

Overview

Control streaming of captured movie.

Please check the API list for target models.

Once streaming starts, the captured movie converted to JPEG can be obtained with GetLiveViewImage().

See “Control Monitoring” for usage instructions.

Definition

CrError ControlMonitoring(CrDeviceHandle deviceHandle, CrMonitoringOperation operationMode);

Input parameters

Type	Explanation
CrDeviceHandle	deviceHandle
CrMonitoringOperation	operationMode Specify the operation type of streaming. Use CrMonitoringOperation defined in CrDefines.h.

Output parameters

None

Return value

Type	Explanation
CrError	CrError_None on Success CrError_Monitoring_InvalidCalled_AlreadyStart If already started. CrError_Monitoring_InvalidCalled_AlreadyStop If already stopped. CrError_Monitoring_InvalidCalled_LiveViewEnabled if LiveViewEnable setting is set at enable. CrError_Monitoring_InvalidCalled_PlaybackEnabled if you executing playback function. Other than errors above, see Status code & Error

Related API

• SetMonitoringDeliverySetting

• IDeviceCallback::OnWarning

  See: ControlMonitoring callback

  See: ControlMonitoring error event

Special note (details)

This API does not support all models.

OnWarning() is notified only if the operation fails.

Monitoring delivery using Camera Remote SDK and other application using different streaming formats cannot be used at the same time.