Obsługa zdarzeń asynchronicznych statusu drukarek


Moduły

 Typy zdarzeń

Definicje typów

typedef void( POSNET_CALLBACK_T )(unsigned long status)
 Typ definiujący funkcję callback dla zdarzeń asynchronicznych. Przyjmuje jeden parametr
  • złożony status urządzenia (w/g wzoru: (Status urządzenia * 65536)+status mechanizmu ) .


Funkcje

POSNET_API void *__stdcall POS_GetSemaphore (POSNET_HANDLE hLocalDevice)
 Pobranie semafora synchronizującego wątki pthread (typ sem_t).
POSNET_API POSNET_STATUS __stdcall POS_SetCallback (POSNET_HANDLE hLocalDevice, POSNET_CALLBACK_T *callback)
 Funkcja ustawia w bibliotece funkcję callback, która będzie wywoływana po otrzymaniu zdarzenia asynchronicznego.
POSNET_API POSNET_STATUS __stdcall POS_SetEventHandlingMode (POSNET_HANDLE hLocalDevice, unsigned long eventMode)
 Ustaw metodę obsługi zdarzeń asynchronicznych.

Dokumentacja definicji typów

typedef void( POSNET_CALLBACK_T)(unsigned long status)

Typ definiujący funkcję callback dla zdarzeń asynchronicznych. Przyjmuje jeden parametr

  • złożony status urządzenia (w/g wzoru: (Status urządzenia * 65536)+status mechanizmu ) .

Definicja w linii 772 pliku posnet.h.


Dokumentacja funkcji

POSNET_API void* __stdcall POS_GetSemaphore ( POSNET_HANDLE  hLocalDevice  ) 

Pobranie semafora synchronizującego wątki pthread (typ sem_t).

Parametry:
hLocalDevice Uchwyt lokalny urządzenia. Funkcja pomimo pobierania uchwytu lokalnego ma zasięg globalny dla urządzenia.
Zwraca:
NULL w przypadku błędu, w przeciwnym wypadku wskaźnik na semafor.
Tylko dla Linux

POSNET_API POSNET_STATUS __stdcall POS_SetCallback ( POSNET_HANDLE  hLocalDevice,
POSNET_CALLBACK_T callback 
)

Funkcja ustawia w bibliotece funkcję callback, która będzie wywoływana po otrzymaniu zdarzenia asynchronicznego.

Parametry:
hLocalDevice Uchwyt lokalny urządzenia. Funkcja pomimo pobierania uchwytu lokalnego ma zasięg globalny dla urządzenia.
callback wskaźnik na funkcję typu callback.

POSNET_API POSNET_STATUS __stdcall POS_SetEventHandlingMode ( POSNET_HANDLE  hLocalDevice,
unsigned long  eventMode 
)

Ustaw metodę obsługi zdarzeń asynchronicznych.

Drukarka ma możliwość generacji zdarzeń asynchronicznych w postaci zmian statusu drukarki, które muszą być przesłane do aplikacji. Tego typu zdarzenia można przesłać do aplikacji w następujący sposób:

  • za pomocą IPC typu "Event"
  • za pomocą komunikatów systemu Windows (Windows Messages)
  • za pomocą systemu pollingu, gdzie aplikacja odpytuje o status

Funkcja służy to ustawienia trybu sygnalizacji zdarzeń.

Parametry:
hLocalDevice Uchwyt lokalny urządzenia. Funkcja pomimo pobierania uchwytu lokalnego ma zasięg globalny dla urządzenia.
eventMode Typ sygnalizacji zdarzeń definiowany przez Typy zdarzeń
Zwraca:
Status wykonania funkcji (POSNET_STATUS_OK w przypadku sukcesu)


Wygenerowano Sat Feb 20 17:17:14 2010 dla POSNET COMBO DF LIBRARY programem  doxygen 1.5.5