comm/datamodem

De apparaatklasse comm/datamodem bestaat uit datamodem-apparaten. U hebt toegang tot deze apparaten met behulp van de -- en communicatiefuncties. Apparaten in deze klasse zijn gekoppeld aan regelapparaten die ondersteuning bieden voor het LINEMEDIAMODE_DATAMODEM mediatype, dat is opgegeven in de dwMediaModes lid van de LINEDEVCAPS- structuur voor het lijnapparaat.

De functie lineGetID vult een VARSTRING- structuur in, stelt dwStringFormat- in op de STRINGFORMAT_BINARY-waarde en voegt deze extra leden toe:

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

Het hComm lid is de ingang van de open communicatiepoort. Dit lid is NULL- als de poort nog niet is geopend of als de parameter dwSelect van lineGetID- niet de LINECALLSELECT_CALL waarde is. Als een oproep actief is, opent de serviceprovider doorgaans de poort zelf om direct controle te krijgen over de communicatiehardware, maar is alleen vereist om een geldige ingang te retourneren als de lijn is verbonden. De serviceprovider opent de poort met behulp van de FILE_FLAG_OVERLAPPED waarde en configureert vervolgens de poort met behulp van de instellingen die zijn opgegeven door de lineSetDevConfig-functie. U kunt extra configuratieopties voor het apparaat instellen met behulp van communicatiefuncties met de geretourneerde ingang.

De szDeviceName lid is een null-tekenreeks-beëindigd waarmee de naam wordt opgegeven van de communicatiepoort die is gekoppeld aan de regel, het adres of de aanroep.

Als hComm- een geldige ingang is, kunt u deze gebruiken in volgende aanroepen naar bestandsfuncties, zoals ReadFile- en WriteFile-, om gegevens over de aanroep te verzenden en te ontvangen. Wanneer u klaar bent met het gebruik van de communicatiepoort en bij voorkeur voordat u de functie lineDeallocateCall gebruikt om de toewijzing van de aanroep ongedaan te maken, moet u de poort sluiten met behulp van de functie CloseHandle.

Wanneer u de functies lineGetDevConfig en lineSetDevConfig gebruikt, hebben sommige serviceproviders de volgende indeling nodig voor de configuratiegegevens voor deze apparaatklasse:

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;

Hieronder vindt u informatie over apparaatconfiguratie voor gebruik met de functies lineGetDevConfig en lineSetDevConfig.

dwSize

De som van de grootte van de DEVCFGHDR structuur en de werkelijke grootte van de COMMCONFIG structuur.

dwVersion-

Versienummer van de Unimodem DevConfig structuur. Dit lid kan worden MDMCFG_VERSION (0x00010003).

fwOptions-

Optievlagken die worden weergegeven op de pagina Unimodem Option. Dit lid kan een combinatie van deze waarden zijn:

TERMINAL_PRE (1)

Geeft het pre-terminalscherm weer.

TERMINAL_POST (2)

Geeft het scherm na de terminal weer.

MANUAL_DIAL (4)

Hiermee wordt de telefoon handmatig gebeld, indien mogelijk.

LAUNCH_LIGHTS (8)

Geeft het modempictogram weer in het statusgebied van de taakbalk.

Alleen de LAUNCH_LIGHTS-waarde is standaard ingesteld

wWaitBong-

Aantal seconden (in twee seconden granulariteit) om de wachttijd voor krediettoon ($) te vervangen.

Commconfig-

COMMCONFIG structuur die kan worden gebruikt met de communicatie- en modemconfiguratiefuncties.