Privilege

Description

Selects or returns the level of the camera control privilege for an ActiveGige-based process. Can be one of the following values:

0 - No Access (read-only)

Process has no access to the camera. Another process has exclusive control over the camera.

1 - Monitor Access

Process has secondary access to the camera. It can read the camera settings and receive the video stream (when the primary application is using Multicast), but cannot modify the camera settings. A process can be allowed monitor access if there is no other active process with exclusive access to the same camera.

2 - Control Access

Process has primary control over the camera. Other processes can read from the camera, but cannot modify its settings..A process can be allowed control access if there is no other active process with exclusive or control access to the same camera.

3 - Exclusive Access

Process has exclusive control over the camera. No other process can access the camera. A process can be allowed exclusive access only if there is no other active process with exclusive or control access to the same camera.

4 - Control with Switchover Access

Process has primary control over the camera. Other processes can read from the camera, but cannot modify its settings..A process can be allowed control access if there is no other active process with exclusive or control access to the same camera, or if the process obtains the right credentials by submitting a correct Control Switchover Key to the camera via the SetControlKey method.

Syntax

[VB]
objActiveGige.Privilege [= Value]

[C/C++]
HRESULT get_Privilege ( short *pValue );
HRESULT put_Privilege( short Value );

Data Type [VB]

Integer


Parameters [C/C++]

Value [in]

Pointer to the ordinal number of the currently selected camera control privilege.

Value [in]

The privilege level to be set.

Return Values

S_OK

Success

E_FAIL

Failure.

Example

This VB example changes the privilege of an application to the Monitor Access:

ActiveGige1.Privilege = 1

Remarks

This property can be used for transferring primary control over the camera from one application (or/and computer) to another. This can be achieved by changing the privilege of a primiry application from the Control to Monitor access and then changing the privilege of a secondary application from the Monitor to Control access. If your camera supports the Control with Switchover access, any application can become a primary one by submitting a correct access key. See SetControlKey for more details.

By default the first ActiveGige-based application that connects to a camera receives the Control Access privilege, while applications that connect to the camera afterwards receive the Monitor Access privilege.