RtgvGetCameraID

RtgvGetCameraID returns the ID of a camera.

Syntax

BOOL RtgvGetCameraID(
    [in]        HANDLE cameraHandle, 
    [out]       LPTSTR pCameraID,
    [in, out]   LPDWORD pSize
); 

Parameters

[in] cameraHandle

The handle of the camera being queried.

[out] pCameraID

A pointer to the buffer that receives the ID of the camera specified by cameraHandle. If this is NULL, the value pointed to by pSize is set to the size needed.

[in, out] pSize

A pointer to a value that specifies the size of pCameraID in bytes.  If the size is not large enough, or if pCameraID is NULL, the function returns FALSE and the value is set to the size needed and last error is set to ERROR_INSUFFICIENT_BUFFER.

Return Values

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

Remarks

The camera ID is a string that contains the Manufacturer Name, Model Name, and IP Address of the camera.

This function will fail if it is called before RtgvInitialize and RtgvInitCameraControl.

To find the camera to query, call RtgvInitialize and then call RtgvEnumerateCameras to get an RTGV_CAMERA_INFO array describing each camera found on the network, along with its handles.

Requirements