Дмитрий Кузан
дата публикации 10-05-2001 00:00

---

Версия для печати

«Все новое ,это хорошо забытое старое»

   BOOL GetCommProperties(
      HANDLE     hFile,
      LPCOMMPROP lpCommProp
    );

typedef struct _COMM_CONFIG 
{
      DWORD dwSize;
      WORD  wVersion;
      WORD  wReserved;
      DCB   dcb;
      DWORD dwProviderSubType;
      DWORD dwProviderOffset;
      DWORD dwProviderSize;
      WCHAR wcProviderData[1];
   } COMMCONFIG, *LPCOMMCONFIG;

dwSize

Задает размер структуры COMMCONFIG в байтах

wVersion

Задает номер версии структуры COMMCONFIG. Должен быть равным 1.

wReserved

Зарезервировано и не используется

dcb

Блок управления устройством (DCB) для порта RS-232.

dwProviderSubType

Задает тип устройства и формат устройство-зависимого блока информации. Фактически это тип порта. Конкретные значения данного поля приведены в описании структуры COMMPROP выше.

dwProviderOffset

Смещение, в байтах, до устройство-зависимого блока информации от начала структуры.

dwProviderSize

Размер, в байтах, устройство-зависимого блока информации.

wcProviderData

Устройство-зависимый блок информации. Это поле может быть любого размера или вообще отсутствовать. Поскольку структура COMMCONFIG может быть в дальшейшем расширена, для определения положения данного поля следует использовать dwProviderOffset. Если dwProviderSubType PST_RS232 или PST_PARALLELPORT, то данное поле отсутствует. Если dwProviderSubType PST_MODEM, то данное поле содержит структуру MODEMSETTINGS.

   BOOL GetCommConfig(
      HANDLE       hCommDev,
      LPCOMMCONFIG lpCC,
      LPDWORD      lpdwSize
   );

hCommDev

Описатель открытого коммуникационного порта.

lpCC

Адрес выделеного и заполненого нулями, кроме поля dwSize, блока памяти под структуру COMMCONFIG. В поле dwSize нужно занести размер структуры COMMCONFIG. После вызова функции все поля структуры будут содержать информацию о текущих параметрах порта.

lpdwSize

Адрес двойного слова, которое после воврата из функции будет содержать число фактически переданных в структуру байт.

   BOOL CommConfigDialog(
      LPTSTR       lpszName,
      HWND         hWnd,
      LPCOMMCONFIG lpCC
   );

lpszName

Указатель на строку с именем порта для которого отображается диалоговое окно. К реальному имени порта эта строка не имеет никакого отношения, она просто выводится в заголовке окна.

hWnd

Описатель окна, которое владеет данным диалоговым окном. Должен быть передан корректный описатель окна-владельца или NULL, если у диалогового окна нет владельца.

lpCC

Указатель на структуру COMMCONFIG. Эта структура содержит начальные установки используемые для отображения в диалоговом окне, и установленные пользователем изменения, при завершении диалога.

   BOOL SetCommConfig(
      HANDLE       hCommDev,
      LPCOMMCONFIG lpCC,
      DWORD        dwSize
   );

   BOOL 
GetDefaultCommConfig(
      LPCSTR       lpszName,
      LPCOMMCONFIG lpCC,
      LPDWORD      lpdwSize
   );

   BOOL SetDefaultCommConfig(
      LPCSTR       lpszName,
      LPCOMMCONFIG lpCC,
      DWORD        dwSize
   );

   BOOL SetupComm(
      HANDLE hFile,
      DWORD  dwInQueue,
      DWORD  dwOutQueue
   );

BOOL ReadFile(
      HANDLE       hFile,
      LPVOID       lpBuffer,
      DWORD        nNumOfBytesToRead,
      LPDWORD      lpNumOfBytesRead,
      LPOVERLAPPED lpOverlapped
   );

   BOOL WriteFile(
      HANDLE       hFile,
      LPVOID       lpBuffer,
      DWORD        nNumOfBytesToWrite,
      LPDWORD      lpNumOfBytesWritten,
      LPOVERLAPPED lpOverlapped
   );

hFile

Описатель открытого файла коммуникационного порта

lpBuffer

Адрес буфера. Для операции записи данные из этого буфера будут передаваться в порт. Для операции чтения в этот буфер будут помещаться принятые из линии данные.

nNumOfBytesToRead, nNumOfBytesToWrite

Число ожидаемых к приему или предназначеных к передаче байт.

nNumOfBytesRead, nNumOfBytesWritten

Число фактически принятых или переданых байт. Если принято или передано меньше данных, чем запрошено, то для дискового файла это свидетельствует об ошибке, а для коммуникационного порта совсем не обязательно. Причина в тайм-аутах.

lpOverlapped

Адрес структуры OVERLAPPED, используемой для асинхронных операций. Подробнее как с структурой, так и с асинхронными операциями мы познакомимся позже. Для синхронных операций данный параметр должен быть равным NULL.

BOOL PurgeComm(
      HANDLE hFile,
      DWORD  dwFlags
   );

• PURGE_TXABORT Немедленно прекращает все операции записи, даже если они не завершены
• PURGE_RXABORT Немедленно прекращает все операции чтения, даже если они не завершены
• PURGE_TXCLEAR Очищает очередь передачи в драйвере
• PURGE_RXCLEAR Очищает очередь приема в драйвере

   BOOL 
FlushFileBuffers(
      HANDLE hFile
   );

BOOL 
TransmitCommChar(
      HANDLE hFile,
      char   cChar
   );

BOOL SetCommBreak(
      HANDLE hFile
   );

   BOOL ClearCommBreak(
      HANDLE hFile
   );

   BOOL EscapeCommFunction(
      HANDLE hFile,
      DWORD  dwFunc
   );

• CLRDTR Сбрасывает сигнал DTR
• CLRRTS Сбрасывает сигнал RTS
• SETDTR Устанавливет сигнал DTR
• SETRTS Устанавливает сигнал RTS
• SETXOFF Симулирует прием символа XOFF
• SETXON Симулирует прием символа XON
• SETBREAK Переводит выходную линию передатчика в состояние разрыва. SetCommBreak является упрощенной формой данного вызова.
• CLRBREAK Снимает состояние разрыва для выходной линии передатчика. ClearCommBreak является упрощенной формой данного вызова.

   BOOL ClearCommError(
      HANDLE    hFile,
      LPDWORD   lpErrors,
      LPCOMSTAT lpStat
   );

hFile

Описатель открытого файла коммуникационного порта.

lpErrors

Адрес переменной, в которую заносится информация об ошибке. В этой переменной могут быть установлены один или несколько из следующих бит:

• CE_BREAK Обнаружено состояние разрыва связи
• CE_DNS Только для Windows95. Параллельное устройство не выбрано.
• CE_FRAME Ошибка обрамления.
• CE_IOE Ошибка ввода-вывода при работе с портом
• CE_MODE Запрошеный режим не поддерживается, или неверный описатель hFile. Если данный бит установлен, то значение остальных бит не имеет значение.
• CE_OOP Только для Windows95. Для параллельного порта установлен сигнал "нет бумаги".
• CE_OVERRUN Ошибка перебега (переполнение аппаратного буфера), следующий символ потерян.
• CE_PTO Только для Windows95. Тайм-аут на параллельном порту.
• CE_RXOVER Переполнение приемного буфера или принят символ после символа конца файла (EOF)
• CE_RXPARITY Ошибка четности
• CE_TXFULL Переполнение буфера передачи

lpStat

Адрес структуры COMMSTAT. Должен быть указан, или адрес выделенного блока памяти, или NULL, если не требуется получать информацию о состоянии.

   typedef struct _COMSTAT
      DWORD fCtsHold:1;
      DWORD fDsrHold:1;
      DWORD fRlsdHold:1;
      DWORD fXoffHold:1;
      DWORD fXoffSent:1;
      DWORD fEof:1;
      DWORD fTxim:1;
      DWORD fReserved:25;
      DWORD cbInQue;
      DWORD cbOutQue;
   } COMSTAT, *LPCOMSTAT;

Поля структуры имеют следующее значение:

fCtsHold

Передача приостановлена из-за сброса сигнала CSR.

fDsrHold

Передача приостановлена из-за сброса сигнала DSR.

fRlsdHold

Передача приостановлена из-за ожидания сигнала RLSD (receive-line-signal-detect). Более известное название данного сигнала - DCD (обнаружение несущей).

fXoffHold

Передача приостановлена из-за приема символа XOFF.

fXoffSent

Передача приостановлена из-за передачи символа XOFF. Следующий передаваемый символ обязательно должен быть XON, поэтому передача собственно данных тоже приостанавливается

fEof

Принят символ конца файла (EOF).

fTxim

В очередь, с помощью TransmitCommChar, поставлен символ для экстреной передачи.

fReserved

Зарезервировано и не используется

cbInQue

Число символов в приемном буфере. Эти символы приняты из линии но еще не считаны функцией ReadFile.

cbOutQue

Число символов в передающем буфере. Эти символы ожидают передачи в линию. Для синхронных операций всегда 0.

   BOOL SetCommMask(
      HANDLE hFile,
      DWORD  dwEvtMask
   );

• EV_BREAK Состояние разрыва приемной линии
• EV_CTS Изменение состояния линии CTS
• EV_DSR Изменение состояния линии DSR
• EV_ERR Ошибка обрамления, перебега или четности
• EV_RING Входящий звонок на модем (сигнал на линии RI порта)
• EV_RLSD Изменение состояния линии RLSD (DCD)
• EV_RXCHAR Символ принят и помещен в приемный буфер
• EV_RXFLAG Принят символ заданый полем EvtChar структуры DCB использованой для настройки режимов работы порта
• EV_TXEMPTY Из буфера передачи передан последний символ

   BOOL GetCommMask(
      HANDLE  hFile,
      LPDWORD lpEvtMask
   );

• EV_EVENT1 Устройство-зависимое событие
• EV_EVENT2 Устройство-зависимое событие
• EV_PERR Ошибка принтера
• EV_RX80FULL Приемный буфер заполнен на 80 процентов

BOOL 
WaitCommEvent(
      HANDLE       hFile,
      LPDWORD      lpEvtMask,
      LPOVERLAPPED lpOverlapped,
   );

   typedef struct _OVERLAPPED {
      DWORD  Internal;
      DWORD  InternalHigh;
      DWORD  Offset;
      DWORD  OffsetHigh;
      HANDLE hEvent;
   } OVERLAPPED, *LPOVERLAPPED

   BOOL GetOverlappedResult(
      HANDLE       hFile,
      LPOVERLAPPED lpOverlapped,
      LPDWORD      lpcbTransfer,
      BOOL         fWait
   );

   DWORD WaitForSingleObject(
      HANDLE hObject,
      DWORD  dwTimeot
   );
   
   DWORD WaitForMultipleObjects(
      DWORD    cObjects,
      LPHANDLE lpHandles,
      BOOL     bWaitAll,
      DWORD    dwTimeout
   );

   #include <windows.h>
   #include <string.h>
      
   . . .
      
   HANDLE        port;
   char*         buf;
   OVERLAPPED    ovr;
   DWORD         bc;

   . . .

   port=CreateFile("COM2",GENERIC_READ,0,NULL,OPEN_EXISTING,
                   FILE_FLAG_OVERLAPPED,NULL);
   
   memset(&ovr,0,sizeof(ovr));
   ovr.hEvent=CreateEvent(NULL,FALSE,FALSE,NULL);
   ReadFile(port,buf,buf_size,&bc,&ovr);
   
   /* Выполняем некую полезную работу */
   
   if(WaitForSingleObject(ovr.hEvent,10000)==WAIT_OBJECT_0) {
      GetOverlappedResult(port,&ovr,&bc,FALSE);
   } else {
   
      /* Обработка ошибки */
   
   }   
   CloseHandle(port);
   CloseHandle(ovr.hEvent);

Дмитрий Кузан
10 мая 2001г.
Специально для Королевства Delphi