Callback-Mechanismus Aktivieren - HEIDENHAIN ND 287 Benutzerhandbuch

8.65

Callback-Mechanismus aktivieren

Der Callback-Mechanismus wird aktiviert, bzw. deaktiviert und gegebenenfalls der Funktionspointer gespeichert. Die Call-
back-Funktion wird aufgerufen, wenn mindestens so viele Elemente im FIFO gespeichert sind, wie im Parameter „threshold"
angegeben. Anschließend wird die Funktion erst wieder aufgerufen, wenn neue Daten in den FIFO geschrieben wurden, und
danach mindestens „threshold" Elemente im FIFO gespeichert sind.
Funktion
ND2_ERR ND2SetDataCallback
Parameter
ND2 ND2-Handle
data Pointer auf Benutzerdaten, dieser Pointer wird als Parameter an die Callback-Funktion übergeben
activate Callback aktivieren oder deaktivieren
activate
ND2_MD_Disable
ND2_MD_Enable
threshold Anzahl der Elemente im FIFO, ab dem der Callback-Mechanismus auslöst (>0)
handler Pointer auf die Callback-Funktion (NULL ist erlaubt, falls activate = 0)
Rückgabewert
Der Rückgabewert liefert einen Status für den Funktionsaufruf. Alle möglichen Werte sind bei den Standard Rückgabewerten
aufgelistet.
Callback-Funktion
Die Callback-Funktion wird vom Treiber ausgeführt und läuft in einem separaten Thread. Der Benutzer muss sich selbst um
die eventuell notwendige Synchronisation mit dem Hauptprogramm kümmern. Der Parameter „ND2" enthält das Handle auf
den ND 287, welche den Callback ausgelöst hat. In „cnt" steht die Anzahl der aktuell im FIFO gespeicherten Elemente. Der
Parameter „data" enthält den Pointer, welcher bei der Registrierung der Callback-Funktion angegeben wurde.
Prototyp
typedef void (*ND2OnDataAvailable)
Parameter
ND2 ND2-Handle
cnt Anzahl der Elemente im FIFO
data Pointer auf Benutzerdaten
40
( ND2_HANDLE
void*
ND2_MODE
unsigned long
ND2OnDataAvailable
)
Beschreibung
Callback Mechanismus deaktivie-
ren
Callback Mechanismus aktivieren
( ND2_HANDLE
unsigned long
void*
)
ND2,
data,
activate,
threshold,
handler
ND2,
cnt,
data