 |
 |
|---|---|
USB 3 uEye CP Rev. 2 GigE |
USB 3 uEye CP Rev. 2 GigE |
Syntax
INT is_DeviceFeature (HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)
Beschreibung
Mit is_DeviceFeature() können kameraspezifische Funktionen einiger uEye-Modelle konfiguriert werden:
•USB 3 uEye CP Rev. 2: Der Temperaturstatus der Kamera kann abgefragt werden. Die Überwachung des Temperaturstatus ist wichtig für den internen Bildspeicher der Kamera (siehe Internen Bildspeicher verwenden).
•GigE uEye CP Rev. 2/GigE uEye FA/GigE uEye SE Rev. 4: Der Temperaturstatus der Kamera kann abgefragt werden.
Über den Übergabeparameter nCommand wird dabei der Funktionsmodus gewählt. Der Übergabeparameter pParam ist abhängig vom Funktionsmodus unterschiedlich belegt; bei Funktionen zum Setzen oder Rücklesen eines Wertes enthält pParam einen Zeiger auf eine Variable vom Typ UINT. Die Größe des Speicherbereichs, auf den pParam verweist, wird im Übergabeparameter cbSizeOfParam angegeben.
Abb. 198: Temperaturstatus bei USB 3 uEye CP Rev. 2
Abb. 199: Temperaturstatus bei GigE uEye CP Rev. 2/FA/SE Rev. 4
Übergabeparameter
hCam |
Handle auf Kamera |
pParam |
Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist. |
cbSizeOfParam |
Größe des Speicherbereichs in Byte, auf den pParam verweist. |
Statusflags aus DEVICE_FEATURE_MODE_CAPS
IS_DEVICE_FEATURE_CAP_TEMPERATURE_STATUSCC |
Überwachung des Temperaturstatus wird unterstützt. Folgende Statusmeldungen sind möglich: •0 = TEMPERATURE_CONTROL_STATUS_NORMAL •1 = TEMPERATURE_CONTROL_STATUS_WARNING •2 = TEMPERATURE_CONTROL_STATUS_CRITICAL |
Verwandte Funktionen
•Internen Bildspeicher verwenden
// Wird die Abfrage des Temperaturstatus unterstützt?
INT nFeatures = 0;
is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_SUPPORTED_FEATURES, &nFeatures, sizeof(nFeatures));
if ((nFeatures & IS_DEVICE_FEATURE_CAP_TEMPERATURE_STATUS) == IS_DEVICE_FEATURE_CAP_TEMPERATURE_STATUS)
{
…
}
// Temperarturstatus abfragen
INT nTemperatureStatus = 0;
is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_TEMPERATURE_STATUS, &nTemperatureStatus, sizeof(nTemperatureStatus));
if (nTemperatureStatus == TEMPERATURE_CONTROL_STATUS_CRITICAL)
{
…
}
else if (nTemperatureStatus == TEMPERATURE_CONTROL_STATUS_WARNING)
{
…
}
else if (nTemperatureStatus == TEMPERATURE_CONTROL_STATUS_NORMAL)
{
…
}
