# Obsługa podstawowa urządzenia

## Moduły
| Identyfikatory parametrów urządzenia
| Rodzaje interfejsu urządzenia
## Funkcje
POSNET_API POSNET_STATUS __stdcall | POS_CloseDevice (POSNET_HANDLE hLocalDevice)
| Zamknij urządzenie.
POSNET_API POSNET_HANDLE __stdcall | POS_CreateDeviceHandle (unsigned long deviceType)
| Utworzenie uchwytu do nowego urządzenia kasowego.
POSNET_API POSNET_STATUS __stdcall | POS_DestroyDeviceHandle (POSNET_HANDLE hGlobalDevice)
| Usuń istniejący uchwyt urządzenia i zwolnij zajmowaną pamięć.
POSNET_API POSNET_STATUS __stdcall | POS_GetDeviceParam (POSNET_HANDLE hDevice, unsigned long paramCode, void *paramValue)
| Funkcja do pobierania parametrów urządzenia.
POSNET_API POSNET_STATUS __stdcall | POS_ModemDial (POSNET_HANDLE hGlobalDevice, int wait)
| Funkcja słuąy do nawiązania połączenia modemowego. Procedura rozpoczyna proces nawiązywania połączenia modemowego.
POSNET_API POSNET_STATUS __stdcall | POS_ModemDisconnect (POSNET_HANDLE hGlobalDevice, int wait)
| Funkcja słuzy do rozłączenia połączenia modemowego. Procedura rozpoczyna proces zamykania połączenia modemowego.
POSNET_API POSNET_STATUS __stdcall | POS_ModemStatus (POSNET_HANDLE hGlobalDevice)
| Funkcja słuzy do sprawdzenia stanu połączenia modemowego.
POSNET_API POSNET_STATUS __stdcall | POS_ModemWrite (POSNET_HANDLE hGlobalDevice, const char *buffer)
| Funkcja umożliwia zapis ciągu znaków bezpośrednio do portu szeregowego (modemu), do wykorzystania wyłącznie w trybie włączonego modemu.
POSNET_API POSNET_HANDLE __stdcall | POS_OpenDevice (POSNET_HANDLE hGlobalDevice)
| Otwórz urządzenie.
POSNET_API POSNET_STATUS __stdcall | POS_SetDeviceParam (POSNET_HANDLE hDevice, unsigned long paramCode, void *paramValue)
| Funkcja do ustawiania parametrów urządzenia.

## Dokumentacja funkcji

POSNET_API POSNET_STATUS __stdcall POS_CloseDevice | ( | POSNET_HANDLE | hLocalDevice | ) |

Zamknij urządzenie.

Zamyka urzadzenie wskazywane przez uchwyt. Usuwa zawartości kolejek komunikacyjnych. Wszytskie dane należy odczytać przed zamknięciem urządzenia.

Parametry:

  | hLocalDevice | Uchwyt urzadzenia do zamknięcia.

POSNET_API POSNET_HANDLE __stdcall POS_CreateDeviceHandle | ( | unsigned long | deviceType | ) |

Utworzenie uchwytu do nowego urządzenia kasowego.

Tworzy odpowiedni obiekt i ustawia niebędne jego właściwości, ale fizycznie go nie otwiera. Przed otwarciem urządzenia należy ustawić niebędne parametry, które są rózne w zależności od typu urządzenia.

Parametry:

  | deviceType | Typ podłączonego urządzenia Typy podłączenia

Zwraca:
  Uchwyt globalny utworzonego urządzenia. Wartośc NULL zostanie zwrócona wyłącznie w przypadku braku pamięci lub podania błędnego typu urządzenia.

POSNET_API POSNET_STATUS __stdcall POS_DestroyDeviceHandle | ( | POSNET_HANDLE | hGlobalDevice | ) |

Usuń istniejący uchwyt urządzenia i zwolnij zajmowaną pamięć.

Ostatecznie usuwa obiekt komunikacyjny i zwalnia pamięć.

Parametry:

  | hGlobalDevice | Uchwyt globalny urządzenia do usunięcia. Wszystkie wątki muszą najpierw zamknąć urzadzenie, w przeciwnym wypadku funkcja zwróci błąd POSNET_STATUS_BUSY.

POSNET_API POSNET_STATUS __stdcall POS_GetDeviceParam | ( | POSNET_HANDLE | hDevice,
|  | unsigned long | paramCode,
|  | void * | paramValue |
| ) |  |  |

Funkcja do pobierania parametrów urządzenia.

Parametry:

  | hDevice | Uchwyt urządzenia - zarówno lokalny jak i globalny
  | paramCode | Kod parametru por. Identyfikatory parametrów urządzenia kody parametrów
  | paramValue | Wskaźnik lub wartość parametru. Opis przy parametrach urządzenia.

POSNET_API POSNET_STATUS __stdcall POS_ModemDial | ( | POSNET_HANDLE | hGlobalDevice,
|  | int | wait |
| ) |  |  |

Funkcja słuąy do nawiązania połączenia modemowego. Procedura rozpoczyna proces nawiązywania połączenia modemowego.

Parametry:

  | hGlobalDevice | Uchwyt globalny urzadzenia typu RS232
  | wait | Flaga oczekiwania na wykonanie polecenia - 0 - nie oczekuj, 1 - oczekuj, ponieważ czas wykonania połączenia modemowego może osiągać nawet ponad minutę dla aplikacji współpracującej z biblioteką wskazane może być samodzielne sprawdzenie statusu dzwonienia funkcją POS_ModemStatus

Zwraca:
  Status wykonania polecenia

POSNET_API POSNET_STATUS __stdcall POS_ModemDisconnect | ( | POSNET_HANDLE | hGlobalDevice,
|  | int | wait |
| ) |  |  |

Funkcja słuzy do rozłączenia połączenia modemowego. Procedura rozpoczyna proces zamykania połączenia modemowego.

Parametry:

  | hGlobalDevice | Uchwyt globalny urzadzenia typu RS232
  | wait | Flaga oczekiwania na wykonanie polecenia - 0 - nie oczekuj, 1 - oczekuj, chociaż czas rozłączenia połączenia modemowego jest dość krótki to dla spółności ze sposobem obsługi połączenia dostepne są oba tryby pracy

Zwraca:
  Status wykonania polecenia

POSNET_API POSNET_STATUS __stdcall POS_ModemStatus | ( | POSNET_HANDLE | hGlobalDevice | ) |

Funkcja słuzy do sprawdzenia stanu połączenia modemowego.

Parametry:

  | hGlobalDevice | Uchwyt globalny urzadzenia typu RS232

Zwraca:
  Status połączenia modemowego POSNET_STATUS_MODEM_xxx

POSNET_API POSNET_STATUS __stdcall POS_ModemWrite | ( | POSNET_HANDLE | hGlobalDevice,
|  | const char * | buffer |
| ) |  |  |

Funkcja umożliwia zapis ciągu znaków bezpośrednio do portu szeregowego (modemu), do wykorzystania wyłącznie w trybie włączonego modemu.

Parametry:

  | hGlobalDevice | Uchwyt globalny urzadzenia typu RS232
  | buffer | Ciąg znaków do wysłania do modemu

Zwraca:
  Status wykonania rozkazu

POSNET_API POSNET_HANDLE __stdcall POS_OpenDevice | ( | POSNET_HANDLE | hGlobalDevice | ) |

Otwórz urządzenie.

Parametry:

  | hGlobalDevice | Uchwyt globalny urzadzenia do otwarcia.

Zwraca:
  Zwraca uchwyt lokalny do urządzenia w kontekście bieżącego wątku. NULL w przypadku błędu, kod błędu można odczytać funkcją POS_GetError

POSNET_API POSNET_STATUS __stdcall POS_SetDeviceParam | ( | POSNET_HANDLE | hDevice,
|  | unsigned long | paramCode,
|  | void * | paramValue |
| ) |  |  |

Funkcja do ustawiania parametrów urządzenia.

Parametry:

  | hDevice | Uchwyt urządzenia - zarówno lokalny jak i globalny
  | paramCode | Kod parametru por. Identyfikatory parametrów urządzenia kody parametrów
  | paramValue | Wskaźnik lub wartość parametru. Opis przy parametrach urządzenia.