UKEY虚拟通道方式流程分析
最后更新 05-08-19
一 UKEY－虚拟通道整体架构
二 TermRWVC 虚拟通道client
由TSSysInf的client端
（E:\Program Files\Microsoft SDK\samples\winbase\WtsApi\TSSysInf\Client\SysInf_C.c）程序改写。
1 服务器端程序TermRWVC运行在PC上，提供5个接口函数供UKEY厂商调用。
1). 打开设备
TERMRWVC_API HANDLE CreateFileCenterm(char * lpFileName);
2). 关闭设备
TERMRWVC_API BOOL CloseHandleCenterm(HANDLE hFile);
3). 读取文件
TERMRWVC_API BOOL ReadFileCenterm( HANDLE hFile,
LPVOID lpBuffer,
DWORD nNumberOfBytesToRead,
LPDWORD lpNumberOfBytesRead,
LPOVERLAPPED lpOverlapped);
4). 写入文件
TERMRWVC_API BOOL WriteFileCenterm( HANDLE hFile,
LPCVOID lpBuffer,
DWORD nNumberOfBytesToWrite,
LPDWORD lpNumberOfBytesWritten,
LPOVERLAPPED lpOverlapped);
5) .设置波特率(与串口扩展兼容)
TERMRWVC_API BOOL ComSetCenterm( HANDLE hFile,
unsigned long ulBaudRate);
#define TAXUSBNAME TEXT("TAX1:")
//提供Usb接口，设备名为TAX1:
2 TermRWVC.cpp中主要完成以下操作：
1） DllMain，DLL的入口
2） 打开虚拟通道操作OpenTaxVc，调用WTSVirtualChannelOpen函数打开虚拟通道，该函数在2003SDK的Wtsapi32.h中定义。
3） 关闭虚拟通道操作CloseTaxVc
4） 读写虚拟通道操作DoTaxVc
5） 实现打开设备CreateFileCenterm，以TSUSBHSOPEN状态为参数调用DoTaxVc函数。
6） 实现关闭设备CloseHandleCenterm，以TSUSBHSCLOSE状态为参数调用DoTaxVc函数。
7） 实现读取文件ReadFileCenterm，以TSUSBHSREAD状态为参数调用DoTaxVc函数。
8） 实现写入文件WriteFileCenterm，以TSUSBHSWRITE状态为参数调用DoTaxVc函数。
9） 设置波特率ComSetCenterm没有实现。
3 DoTaxVc函数分析
涉及到的类结构TS_USB_DATA *p_usbdata，在StdAfx.h （E:\project\UKEY\天安信源代码\TermRWVC050201\TermRWVC\StdAfx.h）中有定义。
根据dwOPtype的类型判断是以下哪种状态，执行相应的操作
1）TSUSBHSOPEN ,
2）TSUSBHSCLOSE
3） TSUSBHSREAD ，调用WTSVirtualChannelRead
4) TSUSBHSWRITE
5) TSUSBHSSMASK 0x0ce37 //SERVER data
6) TSUSBHSCMASK 0x0ce25 //CLIENT data
7) TSUSBHSTIMEOUT 40000;//INFINITE;
三 usbVTC 虚拟通道Server
由TSSysInf的server端
（E:\Program Files\Microsoft SDK\samples\winbase\WtsApi\TSSysInf\Server）程序改写。
1 SysInfo.h由E:\Program Files\Microsoft SDK\samples\winbase\WtsApi\TSSysInf\Inc\SysInfo.h针对USBKEY做了部分修改：
1） 增加了虚拟通道USB操作类型的声明
2） 增加了类结构TS_USB_DATA 的声明
3） 增加了BOOL ReadUsbData(void)函数声明
4） 增加了BOOL WriteUsbData(DWORD dwlen,char * pszdata) 函数声明
2
VirtualChannelInitEventProc函数（SysInf_C.cpp）
1）Event事件定义
Value
Meaning
CHANNEL_EVENT_CONNECTED
A connection has been established with a terminal server that supports virtual channels. The pData parameter is a pointer to a null-terminated string with the name of the server.
CHANNEL_EVENT_DISCONNECTED
The connection to the terminal server has been disconnected. The pData parameter is NULL.
CHANNEL_EVENT_INITIALIZED
The Terminal Services client initialization has been completed. The pData parameter is NULL.
CHANNEL_EVENT_TERMINATED
The client has been terminated. The pData parameter is NULL.
CHANNEL_EVENT_V1_CONNECTED
A connection has been established with a terminal server that does not support virtual channels. The pData parameter is NULL.
CHANNEL_EVENT_REMOTE_CONTROL_START
A remote control operation has been started. The pData parameter is NULL.
CHANNEL_EVENT_REMOTE_CONTROL_STOP
A remote control operation has been terminated. The pData parameter is a pointer to a null-terminated string containing the name of the server.
2) PCHANNEL_ENTRY_POINTS pEntryPoints类结构体定义
typedef struct tagCHANNEL_ENTRY_POINTS {
DWORD cbSize;
DWORD protocolVersion;
PVIRTUALCHANNELINIT pVirtualChannelInit;
PVIRTUALCHANNELOPEN pVirtualChannelOpen;
PVIRTUALCHANNELCLOSE pVirtualChannelClose;
PVIRTUALCHANNELWRITE pVirtualChannelWrite;
} CHANNEL_ENTRY_POINTS, *PCHANNEL_ENTRY_POINTS;
3) CHANNEL_EVENT_CONNECTED事件处理流程：
3 VirtualChannelOpenEvent 函数
1）event 事件定义
[in] Indicates the event that caused the notification. This parameter can be one of the following values.
Value
Meaning
CHANNEL_EVENT_DATA_RECEIVED
The virtual channel received data from the server end. pData is a pointer to a chunk of the data. dataLength indicates the size of this chunk. totalLength indicates the total size of the data written by the server.
CHANNEL_EVENT_WRITE_CANCELLED
A write operation started by a VirtualChannelWrite call has been canceled. pData is the value specified in the pUserData parameter of VirtualChannelWrite.
A write operation is canceled when the client session is disconnected. This notification enables you to free any memory associated with the write operation.
CHANNEL_EVENT_WRITE_COMPLETE
A write operation started by a VirtualChannelWrite call has been completed. pData is the value specified in the pUserData parameter of VirtualChannelWrite.
4 WorkerThread线程函数
监听由客户端发来的指令
