Privilege
Top  Previous  Next

Description

Selects or returns the level of the camera control privilege for an ActiveGeni-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, 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 may be able to 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.  
 

Syntax


[VB]
objActiveGeni.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:

ActiveGeni1.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.

By default the first ActiveGeni-based application that connects to a camera receives the Control or Exclusive access, while applications that connect to the camera afterwards attempt to receive the Monitor Access.