RtgvReadRegister

RtgvReadRegister reads a value from a register on the camera.

Syntax

Copy

BOOL RtgvReadRegister(
    [in]    UINT32 cameraHandle, 
    [in]    UINT32 registerAddress, 
    [out]   PVOID pValue,
    [in]    UINT8 length,
    [in]    BOOL isBigEndian
);

Parameters

[in] cameraHandle

A handle to the camera.

[in] registerAddress

The address of the register to read.

[out] pValue

A pointer to the variable that stores the value from the register.

[in] length

The length of the value.

[in] isBigEndian

A flag indicating whether the value is in big-endian format.

Return Values

If the function succeeds, it returns TRUE. If the function fails, it returns FALSE. Call GetLastError to obtain an error code.

Possible error codes:

Error code	Meaning
RTGV_ERROR_SOCKET_ERROR	The read operation to socket failed.
ERROR_INVALID_PARAMETER	One of the following conditions occurred: The value of parameter pValue is NULL. The value of parameter length is greater than 4.
ERROR_INVALID_ADDRESS	Parameter registerAddress cannot be divided by 4.
RTGV_GEV_STATUS(GEV_STATUS_INVALID_ADDRESS)	Parameter registerAddress does not exist.

Requirements

Minimum supported version	Header	Library
wRTOS 1.0 SDK	RtgvApi.h	RtgvApi.lib