TCOM5. Функции модуля описания интерфейса

  TCOM5 OpenMedia. Функция инициализации

  TCOM5 CloseMedia. Функция завершения работы

  TCOM5 StartMedia. Функция запуска интерфейса

  TCOM5 StopMedia. Функция остановки интерфейса

  TCOM5 ReadMedia. Функция чтения ответа

  TCOM5 WriteMedia. Функция посылки запроса/данных

МРВ вызывает из модуля media<n>.dll шесть функций.

TCOM5 OpenMedia. Функция инициализации

Эта функция вызывается при инициализации работы МРВ с драйвером. В ней можно прописать операции для установки начальных условий для обмена данными.

 

int OpenMedia(long &hndl);

 

где

hndl – любое отличное от 0 значение – признак интерфейса. Это значение передается в МРВ и затем всегда используется для передачи драйверу в качестве параметра при обращении к данному интерфейсу

  

TCOM5 CloseMedia. Функция завершения работы

Данная функция вызывается при завершении работы МРВ после закрытия протоколов (вызовы функций Close_yyy по всем протоколам).

 

int CloseMedia(long &hndl);

 

где

hndl – признак интерфейса. Это значение передается в МРВ функцией OpenMedia при открытии обмена по данному интерфейсу.

TCOM5 StartMedia. Функция запуска интерфейса

Эта функция вызывается перед началом работы МРВ в реальном времени после вызова функции OpenMedia.

 

int StartMedia(long &hndl);

 

где

hndl – признак интерфейса. Это значение передается в МРВ функцией OpenMedia при открытии обмена по данному интерфейсу.

TCOM5 StopMedia. Функция остановки интерфейса

Эта функция вызывается перед завершением работы МРВ в реальном времени (до закрытия протоколов). Она имеет следующий формат:

 

int StopMedia(long &hndl);

 

где

hndl – признак интерфейса. Это значение передается в МРВ функцией OpenMedia при открытии обмена по данному интерфейсу.

TCOM5 ReadMedia. Функция чтения ответа

Эта функция вызывается для запроса данных у устройств. Она имеет следующий формат:

 

int ReadMedia(long &hndl, char *rbuf, int in_count, int &actual_count);

 

где

hndl – признак интерфейса. Это значение передается в МРВ функцией OpenMedia при открытии обмена по данному интерфейсу;

rbuf – буфер для размещения ответа от внешнего устройства (формируется в драйвере);

in_count – количество символов, которые должны были присутствовать в ответе (передается в драйвер);

actual_count – реальное количество принятых символов (формируется в драйвере).

TCOM5 WriteMedia. Функция посылки запроса/данных

Эта функция вызывается для передачи данных в устройство. Она имеет следующий формат:

 

int WriteMedia(long &hndl, char *sbuf, int out_count, int &actual_count);

 

где

hndl – признак интерфейса. Это значение передается в МРВ функцией OpenMedia при открытии обмена по данному интерфейсу;

sbuf – буфер, содержащий сообщение для посылки в контроллер (передается в драйвер);

out_count – количество символов, которые должны быть переданы в сообщении (передается в драйвер);

actual_count – реальное количество переданных символов (формируется в драйвере).