GetCameraMACList

Description

Returns the array of strings containing the MAC addresses of connected GigE Vision™ devices in the string form.


Syntax

[VB]
Value=objActiveGige.GetCameraMACList()

[C/C++]
HRESULT GetCameraMACList( VARIANT* pList );


Data Types [VB]

Return value: Variant (Array of strings)


Parameters [C/C++]

pList [out,retval]

Pointer to the SAFEARRAY containing MAC addresses

Return Values

S_OK

Success

E_FAIL

Failure.

Example

This VB example initializes a combo box with MAC addresses and uses it to switch between the cameras:

Private Sub Form_Load()
CamMACLst = ActiveGige1.GetCameraMACList
For i = 0 To UBound(CamMACLst)
Combo1.AddItem (CamMACLst(i))
Next
Combo1.ListIndex = 0
ActiveGige1.Acquire = True
End Sub

Private Sub Combo1_Click()
ActiveGige1.Camera = Combo1.ListIndex
End Sub
This MFC example fills out a combo box with MAC addresses:

VARIANT m_CamArray=m_ActiveGige.GetCameraMACList();
SAFEARRAY *pArray=m_CamArray.parray;
UINT nCam=pArray->rgsabound[0].cElements;

CString strCamera;
CComboBox *pCamera=(CComboBox*)GetDlgItem(IDC_CAMERA);
for(UINT i=0;i<nCam;i++)
{
      CString str; str.Format("Camera %d",i);
      pCamera->AddString(str);
}
int iCam=m_ActiveGige.GetCamera();
pCamera->SetCurSel(iCam);

SafeArrayDestroy(pArray);


Remarks

The IP addresses are returned in the standard dashed format such as 00-05-5D-24-6E-5B.

The index of an element in the MAC list can be used as an argument of the Camera property to select a specific device.

Note that in C/C++ applications it is required to call SafeArrayDestroy() to delete the SAFEARRAY returned by GetCameraMACList.