Syntax
INT is_EnableMessage (HIDS hCam, INT which, HWND hWnd)
Beschreibung
Mit is_EnableMessage() können Windows Messages aktiviert/deaktiviert werden. Beim Eintreten eines bestimmten Ereignisses werden die Messages an das Anwenderprogramm gesendet.
Die Nachricht ist wie folgt aufgebaut:
•Message: IS_UEYE_MESSAGE
•wParam: Eingetroffenes Ereignis (siehe Tabelle)
•lParam: zur Message gehörendes uEye Kamera-Handle
|
|
Vor dem Entladen der uEye API müssen die Messages mit hWnd == NULL wieder deaktiviert werden. Andernfalls kann es vorkommen, dass die Anwendung nicht korrekt beendet wird.
|
Übergabeparameter
hCam
|
Handle auf Kamera
|
 | which: ID der Meldung, die aktiviert/deaktiviert werden soll |
IS_AUTOBRIGHTNESS_FINISHED
|
Die automatische Helligkeitsregelung ist abgeschlossen (nur, wenn die Regelung mit IS_SET_AUTO_BRIGHTNESS_ONCE gestartet wurde).
|
IS_AUTOFOCUS_FINISHED
|
Die automatische Regelung für den Fokus ist abgeschlossen (siehe is_Focus()).
|
IS_CAMERA_MEMORY
|
Eine Aufnahmen-Iteration im Kamera-Memory-Modus wurde beendet.
|
IS_CAPTURE_STATUS
|
Beim Datentransfer trat ein Fehler auf, siehe is_CaptureStatus().
Der Parameter IS_CAPTURE_STATUS ersetzt den bisherigen Parameter IS_TRANSFER_FAILED.
Der Parameter IS_TRANSFER_FAILED wurde in die neue Header-Datei ueye_deprecated.h verschoben, die alle veralteten Funktionsdefinitionen und Konstanten enthält. Falls Bedarf besteht, kann die Header-Datei ueye_deprecated.h zusätzlich zu ueye.h eingebunden werden.
|
IS_CONNECTIONSPEED_CHANGED
|
Die Verbindungsgeschwindigkeit einer USB 3 uEye Kamera hat sich von USB 2.0 auf USB 3.0 oder von USB 3.0 auf USB 2.0 geändert.
|
IS_FIRST_PACKET_RECEIVED
|
Das erste Datenpaket des Bildes wurde an den PC übertragen. Dies ist der frühestmögliche Zeitpunkt, an dem festgestellt werden kann, ob die Belichtung des Bildes abgeschlossen ist.
|
IS_FRAME
|
Ein neues Bild steht zur Verfügung.
|
IS_DEVICE_PLUGGED_IN
|
Eine bereits gepairte GigE uEye Kamera wurde wieder mit den Netzwerk verbunden (Voraussetzung: die Kamera wird im Trusted-Pairing-Modus betrieben, siehe is_Configuration()).
|
IS_DEVICE_UNPLUGGED
|
Eine gepairte GigE uEye Kamera wurde vom Netzwerk getrennt (Voraussetzung: die Kamera wird im Trusted-Pairing-Modus betrieben, siehe is_Configuration()).
|
IS_DEVICE_REMOVAL
|
Eine Kamera wurde entfernt
|
IS_DEVICE_REMOVED
|
Eine mit is_InitCamera() geöffnete Kamera wurde entfernt.
|
IS_DEVICE_RECONNECTED
|
Eine mit is_InitCamera() geöffnete und danach entfernte Kamera wurde wieder eingesteckt.
|
IS_NEW_DEVICE
|
Eine neue Kamera wurde eingesteckt.
|
IS_OVERLAY_DATA_LOST
|
Direct3D-/OpenGL-Modus: Durch eine Umprogrammierung sind die Parameter des Overlay ungültig geworden. Das Overlay muss neu gezeichnet werden.
|
IS_PMC_IMAGE_PARAMS_CHANGED
|
Multicast-Betrieb: Der Master hat Kameraparameter geändert, die sich auf das Datenformat auswirken wie z. B. Bildgröße oder Farbformat. Der Client muss die virtuelle Kamera neu konfigurieren.
|
IS_SEQUENCE
|
Die Sequenz wurde durchlaufen.
|
IS_STEAL_VIDEO
|
Ein dem Overlay entzogenes Bild steht zur Verfügung.
|
IS_TEMPERATURE_STATUS
|
Nur USB 3 uEye CP Rev. 2/GigE uEye CP Rev. 2/GigE uEye FA/GigE uEye SE Rev. 4:
Der Temperaturstatus der Kamera hat sich geändert, siehe Temperaturstatus abfragen
|
IS_TRIGGER
|
Ein Bild, dessen Aufnahme durch einen Trigger ausgelöst wurde, wurde komplett übertragen.
Dies ist der frühstmögliche Zeitpunkt für eine neue Aufnahme. Das Bild muss noch das Postprocessing des Treibers durchlaufen und steht nach dem Eintreten der Message IS_FRAME zur Verarbeitung bereit.
|
IS_WB_FINISHED
|
Der automatische Weißabgleich hat seine Regelung beendet (nur, wenn die Regelung mit IS_SET_AUTO_WB_ONCE gestartet wurde).
|
|
hWnd
|
Anwendungsfenster, welches die Message empfängt.
NULL deaktiviert die mit which bezeichnete Message.
|
Rückgabewert
IS_INVALID_CAMERA_HANDLE
|
Ungültiges Kamera-Handle
|
IS_INVALID_PARAMETER
|
Einer der übergebenen Parameter ist außerhalb des gültigen Bereichs, oder für diesen Sensor nicht unterstützt, bzw. in diesem Modus nicht zugänglich.
|
IS_NO_SUCCESS
|
Allgemeine Fehlermeldung
|
IS_SUCCESS
|
Funktion erfolgreich
|
Verwandte Funktionen
•is_InitEvent()