# SimConnect_CameraGet<no value>
The **SimConnect\_CameraGet** function is used to get the current add-on camera properties, regardless of whether it has been acquired or not.

 

##### Syntax

``` cpp
HRESULT SimConnect_CameraGet(
    HANDLE hSimConnect,
    DWORD Referential
    );
```

 

##### Parameters

<table><thead><tr class="header"><th>Parameter</th><th>Description</th><th>Type</th></tr></thead><tbody><tr class="odd"><td><em>hSimConnect</em></td><td>Handle to a SimConnect object.</td><td>Integer</td></tr><tr class="even"><td><em>Referential</em></td><td><p>The referential to use for the camera position values (including the camera "target" position values, if used), can be one of the following <code>SIMCONNECT_POSITION_REFERENTIAL</code> enum members:</p><ol><li><code>SIMCONNECT_POSITION_REFERENTIAL_AIRCRAFT</code> - The position is an offset from the aircraft <a href="../../../../content-configuration/modular-simobjects/aircraft/modular-aircraft-simobjects/#datum-reference-point">Datum Reference Point</a> (expressed in meters).</li><li><code>SIMCONNECT_POSITION_REFERENTIAL_WORLD</code> - The position is expressed using latitude, longitude, and altitude.</li><li><code>SIMCONNECT_POSITION_REFERENTIAL_EYEPOINT</code> - The position is an offset from the aircraft pilot eyepoint (expressed in meters).</li></ol></td><td>enum</td></tr></tbody></table>

 

##### Return Values

The function returns an **HRESULT**. Possible values include, but are not limited to, those in the following table.

{{< table-wrapper >}}

| Return value | Description             |
|--------------|-------------------------|
| S\_OK        | The function succeeded. |
| E\_FAIL      | The function failed.    |

{{< /table-wrapper >}}


 

##### Example

Request camera data:

``` cpp
SimConnect_CameraGet(hSimConnect, SIMCONNECT_POSITION_REFERENTIAL_AIRCRAFT); // Request CameraGet
while (!quit)
{
    SimConnect_CallDispatch(hSimConnect, MyDispatchProc, NULL);
    Sleep(1);
} 
```

 

The user defined dispatch function:

``` cpp
void CALLBACK MyDispatchProc(SIMCONNECT_RECV* pData, DWORD cbData, void* pContext)
{
    switch (pData->dwID)
    {
        case SIMCONNECT_RECV_ID_CAMERA_DATA:
        {
            // Receive the coordinate of the camera
            SIMCONNECT_RECV_CAMERA_DATA* pCam = (SIMCONNECT_RECV_CAMERA_DATA*)pData;
            printf("\n<-Get: %f %f %f %f %f %f %f", pCam->CameraData.Pos.x, pCam->CameraData.Pos.y, pCam->CameraData.Pos.z, pCam->CameraData.Pbh.Pitch, pCam->CameraData.Pbh.Bank, pCam->CameraData.Pbh.Heading, pCam->CameraData.Fov);
            break;
        }
    }
}
```

 

##### Remarks

This function will generate a `SIMCONNECT_DATA_CAMERA` struct which will contain all the information about the current camera, unless the camera has not been acquired, in which case a `SIMCONNECT_EXCEPTION_CAMERA_API` exception will be sent (see `SIMCONNECT_EXCEPTION` for more information).