User manual

Příklad
Níže uvedený kód je částí C aplikace a ukazuje, jak otevírat jedinou jednotku pomocí funkcí
asynchronního otevření jednotky:
//======================================================
// Otevření jednotky asynchronně
//======================================================
// Řekněte ovladači, aby začal výčet jednotek na pozadí
// (okamžitě se vrací usb_tc08_open_unit_async)
result = usb_tc08_open_unit_async();
// vyřešte chybové podmínky
if (result == -1)
{
error_code = usb_tc08_get_last_error(0);
printf("Unit failed to open\nThe error code is %d", error_code);
// zde bylo možné aplikaci ukončit
}
else if (result == 0)
{
printf("No USB TC08 units found");
// zde bylo možné aplikaci ukončit
}
// Žádné chyby, takže začněte
// postupně výčet stavu pomocí volání usb_tc08_open_unit_progress
do
{
result = usb_tc08_open_unit_progress(&handle, &progress);
switch (result)
{
case USBTC08_PROGRESS_FAIL: // enum equates to: -1
error_code = usb_tc08_get_last_error(0);
printf("Unit failed to open\nThe error code is %d", error_code);
// zde bylo možné aplikaci ukončit
break;
case USBTC08_PROGRESS_PENDING: // enum equates to: 0
printf("\nThe unit is %d percent enumerated", progress);
Sleep(500); // wait for approx. half a second
break;
case USBTC08_PROGRESS_COMPLETE: // enum equates to: 1
printf("\n\nThe unit with handle '%d', opened successfully", handle);
break;
}
}
while (result == USBTC08_PROGRESS_PENDING);
//
// Začněte používat otevřenou jednotku
//
usb_tc08_open_unit_progress
short usb_tc08_open_unit_progress( short * handle,
short * progress)
Toto je funkce, která se volá po usb_tc08_open_unit_async. Funkci volejte opakovaně
pro určení stavu procesu výčtu na pozadí. Pro příklad použití viz usb_tc08_open_unit_async.
Argumenty
handle
(Out) Odkaz Pozitivní krátký) jednotce po ukončení výčtu.
Po neúplném ukončení výčtu bude handle vždy 0.
progress
(Out) (volitelně se může vložit NULL) vrací číslo od 0 do 100
a představuje procento zkompletování výčtu jedné jednotky.
Vrací
-1 (USBTC08_PROGRESS_FAIL)
Vyskytla se chyba, volejte usb_tc08_get_last_error
s handle 0 pro získání chybového kódu
0 (USBTC08_PROGRESS_PENDING)
Výčet není ukončený (pokračujte ve volání
usb_tc08_open_unit_progress)
1 (USBTC08_PROGRESS_COMPLETE)
Výčet je ukončený a handle je nyní platný
usb_tc08_close_unit
short tc08_close_unit(short handle)
Tato funkce uzavírá jednotku pro daný handle USB.
Argumenty
handle
Specifikuje jednotku USB TC-08
Vrací
0
- Použití usb_tc08_get_last_error.
1
- Jednotka je úspěšně uzavřena
usb_tc08_stop
short usb_tc08_stop (short handle)
Příkaz zastavuje chod jednotky.
Argumenty
handle
Specifikuje jednotku USB TC-08
Vrací
0
- Neplatný parametr.
1
- Jednotka úspěšně ukončila streaming.
usb_tc08_set_mains
short usb_tc08_set_mains( short handle,
short sixty_hertz)
Tato funkce nastavuje USB TC-08 tak, aby odmítnul 50 Hz nebo 60Hz.
Argumenty
handle
- Specifikuje jednotku USB TC-08
sixty_hertz
- Určuje, jestli odmítnout 50 Hz, nebo 60 Hz. Pokud je nastavení
1, jednotka odmítne 60 Hz a při nastavení 0 odmítne 50 Hz.
Vrací
0
- Použijte usb_tc08_get_last_error.
1
- Správné nastavení odmítnutí sítě
Poznámka: Pokud není odmítnutí nastaveno správně, bude jednotka citlivější na zásahy sítě.