POSNET COMBO LIBRARY: Obsługa obiektów rozkazowych

# Obsługa obiektów rozkazowych
[Obsługa synchroniczna kasy]

## Funkcje
POSNET_API POSNET_STATUS __stdcall | POS_CancelRequest (POSNET_HANDLE hRequest)
| Anulowanie obiektu rozkazowego.
POSNET_API POSNET_HANDLE __stdcall | POS_CreateRequest (POSNET_HANDLE hLocalDevice, POSNET_CMD command)
| Funkcja tworzy nowy obiekt rozkazowy dla kasy.
POSNET_API POSNET_STATUS __stdcall | POS_DestroyRequest (POSNET_HANDLE hRequest)
| Zniszczenie obiektu rozkazowego i zwolnienie zajmowanej przezeń pamięci.
POSNET_API unsigned long __stdcall | POS_GetRequestAge (POSNET_HANDLE hRequest)
| Wiek rozkazu - czas jaki upłynął od wywołania POS_PostRequest.
POSNET_API unsigned long __stdcall | POS_GetRequestCommandID (POSNET_HANDLE hRequest)
| Pobierz numer polecenia, który został użyty przy tworzeniu obiektu.
POSNET_API unsigned long __stdcall | POS_GetRequestCommandSerial (POSNET_HANDLE hRequest)
| Pobierz numer seryjny rozkazu.
POSNET_API POSNET_STATE __stdcall | POS_GetRequestState (POSNET_HANDLE hRequest)
| Zwróć stan rozkazu.
POSNET_API POSNET_STATUS __stdcall | POS_PostRequest (POSNET_HANDLE hRequest, unsigned char mode)
| Fukcja umieszcza obiekt rozkazowy w kolejce rozkazów do wykonania.
POSNET_API POSNET_HANDLE __stdcall | POS_RequestDevice (POSNET_HANDLE hRequest)
| Funkcja służy do pobrania uchwytu urządzenia związanego z rozkazem.
POSNET_API POSNET_STATUS __stdcall | POS_WaitForRequestCompleted (POSNET_HANDLE hRequest, unsigned long timeout)
| Czekaj na zakończenie rozkazu.

## Dokumentacja funkcji

POSNET_API POSNET_STATUS __stdcall POS_CancelRequest | ( | POSNET_HANDLE | hRequest | ) |

Anulowanie obiektu rozkazowego.

Funkcja anuluje wykonanie rozkazu. W zależności od stanu rozkazu może to oznaczać:

- jeśli rozkaz nie został jeszcze wysłany zostaje on usunięty z kolejki rozkazów,
- jeśli rozkaz został wysłany do kasy i jest to rozkaz złożony, który został potwierdzony to następuje próba anulowania poprzez komendę CMPLSEQSTOP, po sukcesie anulowania zostaje on usunięty z kolejki rozkazów,
- jeśli rozkaz był już wykonany to nic nie jest wykonywane i zostaje zwrócony kod błędu POSNET_STATUS_ALREADY_COMPLETED .

W każdym przypadku za zniszczenie obiektu odpowiada aplikacja - należy dla anulowanego rozkazu wywołać POS_DestroyRequest .

Parametry:

  | hRequest | Uchwyt rozkazu

POSNET_API POSNET_HANDLE __stdcall POS_CreateRequest | ( | POSNET_HANDLE | hLocalDevice,
|  | POSNET_CMD | command |
| ) |  |  |

Funkcja tworzy nowy obiekt rozkazowy dla kasy.

Funkcja tworzy obiekt rozkazowy dla kasy. Obiekt tego typu jest podstawową komórką transmisyjną pomiędzy aplikacją a kasą. Jego zadaniem jest realizacja pojedynczej transakcji kasa-aplikacja.

Więcej informacji we wprowadzeniu - Przepływ informacji

Parametry:

  | hLocalDevice | Uchwyt lokalny urządzenia
  | command | Identyfikator rozkazu dla kasy

Zwraca:
  Zwracany jest uchwyt do nowego obiektu rozkazowego lub NULL w przypadku błędu

POSNET_API POSNET_STATUS __stdcall POS_DestroyRequest | ( | POSNET_HANDLE | hRequest | ) |

Zniszczenie obiektu rozkazowego i zwolnienie zajmowanej przezeń pamięci.

Funkcja kasuje obiekt rozkazowy oraz wszystkie powiązane z nim dane. Musi być użyta dla każdego rozkazu allokowanego poprzez POS_CreateRequest POS_CreateRequest który nie jest automatycznie usuwany w ytybach SPOOLSPECIAL i AUTOCLEAR.

Parametry:

  | hRequest | Uchwyt rozkazu

POSNET_API unsigned long __stdcall POS_GetRequestAge | ( | POSNET_HANDLE | hRequest | ) |

Wiek rozkazu - czas jaki upłynął od wywołania POS_PostRequest.

Funkcja ta ma na celu ustalenie wieku rozkazu i może być przydatna w obsłudze sytuacji nadzwyczajnych. Czas podawany jest w milisekundach.

Parametry:

  | hRequest | Uchwyt rozkazu

POSNET_API unsigned long __stdcall POS_GetRequestCommandID | ( | POSNET_HANDLE | hRequest | ) |

Pobierz numer polecenia, który został użyty przy tworzeniu obiektu.

Parametry:

  | hRequest | Uchwyt rozkazu

Zwraca:
  Numer rozkazu lub POSNET_STATUS_INVALIDCOMMAND w przypadku błędu

POSNET_API unsigned long __stdcall POS_GetRequestCommandSerial | ( | POSNET_HANDLE | hRequest | ) |

Pobierz numer seryjny rozkazu.

Parametry:

  | hRequest | Uchwyt urządzenia

Zwraca:
  Numer seryjny rozkazu

POSNET_API POSNET_STATE __stdcall POS_GetRequestState | ( | POSNET_HANDLE | hRequest | ) |

Zwróć stan rozkazu.

Funkcja zwraca stan w jakim aktualnie znajduje się rozkaz. Więcej informacji we wprowadzeniu - Przepływ informacji

Parametry:

  | hRequest | Uchwyt rozkazu

POSNET_API POSNET_STATUS __stdcall POS_PostRequest | ( | POSNET_HANDLE | hRequest,
|  | unsigned char | mode |
| ) |  |  |

Fukcja umieszcza obiekt rozkazowy w kolejce rozkazów do wykonania.

Istnieją dwa warianty wysyłania rozkazów

- tryb kolejkowania,
- tryb bezpośredni.

W trybie kolejkowania nowy rozkaz jest umieszczany w kolejce do wysłania do kasy i automatycznie wysyłany w miarę zwalniania się bufora kasy.

OstrzeĹĽenie:
  Długośc kolejki jest ograniczona. Po jej przekroczeniu rozkazy traktowane są jakby były wysyłane w trybie bezpośrednim.

Tryb bezpośredni kontroluje, czy kasa jest wolna i dopiero gdy jest wolna umożliwia umieszczenie rozkazu w buforze. W ten sposób w danej chwili do kasy wysłany jest co najwyżej 1 rozkaz.

Parametry:

  | hRequest | Uchwyt rozkazu
  | mode | Wybór trybu wysyłania rozkazu Tryby wysyłania rozkazów

POSNET_API POSNET_HANDLE __stdcall POS_RequestDevice | ( | POSNET_HANDLE | hRequest | ) |

Funkcja służy do pobrania uchwytu urządzenia związanego z rozkazem.

Parametry:

  | hRequest | Uchwyt rozkazu

Zwraca:
  uchwyt lokalny urządzenia lub NULL w przypadku błędu lub dla rozkazów odesłanych przez kasę (karta rabatowa), gdyż nie można ustalić adresata rozkazu.

POSNET_API POSNET_STATUS __stdcall POS_WaitForRequestCompleted | ( | POSNET_HANDLE | hRequest,
|  | unsigned long | timeout |
| ) |  |  |

Czekaj na zakończenie rozkazu.

Funkcja powoduje zatrzymanie (uśpienie) wołającej ją aplikacji do momentu zmiany stanu rozkazu na POSNET_RSTATE_COMPLETED lub POSNET_RSTATE_ERRCOMPLETED lub upłynięcia czasu wskazanego przez parametr timeout.

Parametry:

  | hRequest | Uchwyt rozkazu
  | timeout | Czas w ms na jaki ma aplikacja być uśpiona. 0 oznacza natychmiastowy powrót

Zwraca:
  zwraca POSNET_STATUS_OK jeśli rozkaz został juz ukończony lub POSNET_STATUS_TIMEOUT jeśli rozkaz nie zdążył się zakończyć we wskazanym czasie.