čárka/datovýmodem

Třída zařízení comm/datamodem se skládá ze zařízení datamodem. K těmto zařízením se dostanete pomocí souborů a komunikačních funkcí. Zařízení v této třídě jsou přidružena ke spojnicovým zařízením, která podporují typ LINEMEDIAMODE_DATAMODEM média, který je určen v dwMediaModes člen LINEDEVCAPS struktury pro zařízení linky.

Funkce lineGetID vyplní strukturuVARSTRING a nastaví dwStringFormat na hodnotu STRINGFORMAT_BINARY a připojí tyto další členy:

HANDLE hComm;            // file handle to data modem
CHAR   szDeviceName[1];  // name of data modem

Člen hComm je popisovač otevřeného komunikačního portu. Tento člen je null, pokud port ještě není otevřený nebo pokud parametr dwSelectlineGetID není LINECALLSELECT_CALL hodnota. Pokud je volání aktivní, poskytovatel služeb obvykle otevře samotný port, aby získal přímou kontrolu nad komunikačním hardwarem, ale je vyžadován pouze k vrácení platného popisovače, pokud je čára připojena. Poskytovatel služeb otevře port pomocí hodnoty FILE_FLAG_OVERLAPPED a pak nakonfiguruje port pomocí nastavení určených funkcí lineSetDevConfig. Další možnosti konfigurace pro zařízení můžete nastavit pomocí komunikačních funkcí s vráceným popisovačem.

szDeviceName člen je řetězec null-terminated, který určuje název komunikačního portu přidruženého k řádku, adrese nebo volání.

Pokud hComm je platný popisovač, můžete ho použít v následných voláních funkcí souborů, jako je ReadFile a WriteFile, k odesílání a přijímání dat na volání. Po dokončení používání komunikačního portu a nejlépe před použitím lineDeallocateCall funkce uvolnit volání, musíte port zavřít pomocí funkce CloseHandle.

Při použití funkcí lineGetDevConfig a lineSetDevConfig vyžadují někteří poskytovatelé služeb, aby konfigurační data pro tuto třídu zařízení měla následující formát:

typedef struct  tagDEVCFG  {
  DEVCFGHDR   dfgHdr;
  COMMCONFIG  commconfig;
} DEVCFG, *PDEVCFG, FAR* LPDEVCFG;

// Device setting information
typedef struct  tagDEVCFGDR  {
  DWORD       dwSize;
  DWORD       dwVersion;
  WORD        fwOptions;
  WORD        wWaitBong;
} DEVCFGHDR;

Následuje informace o konfiguraci zařízení pro použití s funkcemi lineGetDevConfig a lineSetDevConfig.

dwSize

Součet velikosti struktury DEVCFGHDR a skutečné velikosti struktury COMMCONFIG.

dwVersion

Číslo verze struktury Unimodem DevConfig Tento člen může být MDMCFG_VERSION (0x00010003).

fwOptions

Příznaky možností, které se zobrazují na stránce Možnosti Unimodem. Tento člen může být kombinací těchto hodnot:

TERMINAL_PRE (1)

Zobrazí obrazovku před terminálem.

TERMINAL_POST (2)

Zobrazí obrazovku po terminálu.

MANUAL_DIAL (4)

Telefon vytočí ručně, pokud to dokáže.

LAUNCH_LIGHTS (8)

Zobrazí ikonu modemu ve stavové oblasti hlavního panelu.

Ve výchozím nastavení je nastavena pouze hodnota LAUNCH_LIGHTS.

wWaitBong

Počet sekund (v intervalu dvou sekund) k nahrazení čekání na tón kreditu ($).

commconfig

COMMCONFIG strukturu, kterou lze použít s konfiguračními funkcemi komunikace a modemu.