# 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.
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_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.

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