USB 3.0	USB 3.0

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: Bildspeicher der Kamera aktivieren oder deaktivieren.

Ab IDS Software Suite 4.81 wird die Kamera standardmäßig mit aktiviertem Bildspeicher betrieben. Die Deaktivierung des Speichers ist nicht mehr möglich. Siehe IDS Kameramanager: Zusatzfunktionen. Wenn Sie den "Kompatibilitätsmodus" aktivieren, können Sie den internen Bilderspeicher wieder deaktivieren. Dies entspricht dem Kameraverhalten bis einschließlich IDS Software Suite 4.80.2.

•Beachten Sie, dass die Kamera geschlossen sein muss, wenn Sie den Bildspeicher aktivieren oder deaktivieren.

•Einige USB 3 uEye Kameras können nur mit aktiviertem Bildspeicher an USB-2.0-Ports betrieben werden, siehe Kamera- und Sensordaten.

•Mit aktiviertem Bildspeicher können die Kameras mit einem höheren Pixeltakt und Bildrate betrieben werden. Zeitweiligen CPU-Belastungen werden damit ausgeglichen.

•Beachten Sie, dass bei höheren Pixeltakten die Kamera eine höhere Leistungsaufnahme hat. Sorgen Sie daher für eine ausreichende Wärmeableitung, siehe Umgebungsbedingungen USB 3 uEye CP Rev. 2.

Hinweis: Beachten Sie, dass der interne Bildspeicher ab Treiberversion 4.80 nur aktiviert oder deaktiviert werden kann, wenn im Aufruf die Geräte-ID und nicht das Kamera-Handle verwendet wird. Weitere Informationen zu dieser Thematik finden Sie in einer Application Note (Englisch) auf unserer Webseite.

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

Übergabeparameter

hCam	Handle auf Kamera
nCommand IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE Gibt zurück, ob der Bildspeicher in der Kamera aktiviert ist (Beispiel 3). IS_DEVICE_FEATURE_CMD_SET_MEMORY_MODE_ENABLE Aktiviert/Deaktiviert den Bildspeicher in der Kamera (Beispiel 2): •1 = IS_MEMORY_MODE_ON •0 = IS_MEMORY_MODE_OFF IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE_DEFAULT Gibt die Standardeinstellung zurück (Beispiel 4). IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE_SUPPORTED Gibt zurück, ob der interne Bildspeicher unterstützt wird (Beispiel 1).
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

Verwandte Funktionen

•Temperaturstatus abfragen

•is_EnableEvent()

•is_EnableMessage()

Beispiel 1

// Is using the image memory supported?

// Via camera handle
int nMemoryMode;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE_SUPPORTED, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{
 // is supported...

}

// Is using the image memory supported?

// Via device ID

int nMemoryMode;
nRet = is_DeviceFeature(nDevID | IS_USE_DEVICE_ID, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE_SUPPORTED, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{
 // is supported...

}

Beispiel 2

// Enable memory mode, device ID must be used for this purpose
UINT nEnable = IS_MEMORY_MODE_ON;
INT nRet = is_DeviceFeature(nDevID | IS_USE_DEVICE_ID, IS_DEVICE_FEATURE_CMD_SET_MEMORY_MODE_ENABLE, (void*)&nEnable, sizeof(nEnable));

Beispiel 3

// Query the status of the image memory via camera handle
int nMemoryMode;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{
 …

}

// Query the status of the image memory via device ID

int nMemoryMode;
nRet = is_DeviceFeature(nDevID | IS_USE_DEVICE_ID, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{
 …

}

Beispiel 4

// Query the default setting for the image memory via camera handle
int nMemoryMode;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE_DEFAULT, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{
 …

}

// Query the default setting for the image memory via device ID

int nMemoryMode;
nRet = is_DeviceFeature(nDevID | IS_USE_DEVICE_ID, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE_DEFAULT, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{
 …

}