一． SPI函数
SPI函数有11个，分别是：https://blog.csdn.net/u011602666/article/details/39232991(合作联系头像)
WFPOpen：该函数主要是建立一个XFSMANGER和指定sp之间连接，支持操作，并初始化该会话。
WFPGetInfo：该函数是获取该sp设备的状态信息。
WFPExecute：具体的设备工作指令都是在该函数中完成的，比如，键盘的加密，打印机的打印数据等。
WFPClose：与WFPOpen函数对应，断开XFSMANGER和指定sp之间的连接。
WFPSetTraceLevel：该函数实际是设置sp调用的步骤进行记录。
WFPDeregister; 注销事件，取消将指定的事件发送到指定窗口，实际上就是删除掉链表里的某节点。
WFPCancelAsyncRequest;取消某个正在执行的一步请求。
WFPRegister; 注册事件，将指定的事件发送到指定窗口，一般注册事件的时候是将该事件存到链表里。
WFPUnloadService;询问the XFS Manager是否可以释放掉sp了.
WFPLock：该函数暂时可不考虑，一般是多应用访问一个设备时候用到。
WFPUnlock：同上。
二． SP 里内存管理
WOSA/XFS中有关内存管理策略的几个函数，它们分别是WFMAllocateBuffer、WFMAllocateMore、WFMFreeBuffer、WFSFreeResult。对于上面的四个函数来讲，WFMFreeBuffer和WFSFreeResult可以合为一个来看，因为WFSFreeResult主要是提供给上层应用程序释放SP返回的WFSResult结构的，其内部实现与WFMFreeBuffer一样，所以我们可以认为WOSA/XFS中只有三个内存管理函数WFMAllocateBuffer、WFMAllocateMore、WFMFreeBuffer。这三个函数与C语言里面的库函数malloc、realloc、free的功能是一一对应的。WFMAllocateBuffer用来分配一块内存，WFMAllocateMore是在WFMAllocateBuffer分配的基础上再多分配一块内存，WFMFreeBuffer是用来释放前两者分配的内存的。
三．SP的结构特点
其实，SP的11个函数结构都是一样的，都要求异步实现下面我以pinpad里一个WFPOpen为例子：
WFPOpen(HSERVICE hService, LPSTR lpszLogicalName,
HAPP hApp, LPSTR lpszAppID, DWORD dwTraceLevel,
DWORD dwTimeOut, HWND hWnd, REQUESTID ReqID,
HPROVIDER hProvider, DWORD dwSPIVersionsRequired,
LPWFSVERSION lpSPIVersion, DWORD dwSrvcVersionsRequired,
LPWFSVERSION lpSrvcVersion)
{
//首先是openport()打开设备串口的操作，要判断是否成功。
//然后对传入的一些句柄判断是否有效，如：
if(hService<0)
return WFS_ERR_INVALID_HSERVICE;
//下面就是异步操的实现：
LPWFSRESULT lpWFSResult;
HRESULT allocRs =WFMAllocateBuffer(sizeof(WFSRESULT), WFS_MEM_ZEROINIT, (LPVOID*)&lpWFSResult);
if (WFS_SUCCESS!=allocRs)
{
return WFS_ERR_INVALID_POINTER;
}
lpWFSResult->RequestID=ReqID;
lpWFSResult->hService=hService;
lpWFSResult->lpBuffer=NULL;
lpWFSResult->hResult=WFS_SUCCESS;
hThreadopen=CreateThread(NULL,0,OpenMyThread,lpWFSResult,0,&dwThreadId);
return WFS_SUCCESS;
}
下面就是OpenMyThread的具体实现：
DWORD WINAPI OpenMyThread( LPVOID lpParam )
{
LPWFSRESULT lpBuffer;
lpBuffer=(LPWFSRESULT)lpParam;
SYSTEMTIME lpSystemTime;
GetLocalTime(&lpSystemTime);
lpBuffer->tsTimestamp=lpSystemTime;
lpBuffer->hResult=WFS_SUCCESS;
lpBuffer->u.dwCommandCode=0;
HRESULT hr=PostMessage(Openhwnd,WFS_OPEN_COMPLETE,0,(LPARAM)lpBuffer);
return 0;
}
再列举一个pinpad的WFPExecute函数例子。函数原型为
WFPExecute(HSERVICE hService, DWORD dwCommand, LPVOID lpCmdData,
DWORD dwTimeOut, HWND hWnd, REQUESTID ReqID)
{
对参数有效性进行判断
if (!IsWindow(hWnd))
return WFS_ERR_INVALID_HWND;
if(ReqID<0)
{
return WFS_ERR_INTERNAL_ERROR;
}
if(hService<0)
return WFS_ERR_INVALID_HSERVICE;
//开辟内存
LPWFSRESULT lpWFSResult;
HRESULT allocRs =WFMAllocateBuffer(sizeof(WFSRESULT), WFS_MEM_ZEROINIT, (LPVOID*)&lpWFSResult);
if (WFS_SUCCESS!=allocRs)
{
return WFS_ERR_INVALID_POINTER;
}
lpWFSResult->RequestID=ReqID;
lpWFSResult->hService=hService;
lpWFSResult->u.dwCommandCode=dwCommand;
lpWFSResult->hResult=0;
//具体的执行指令
switch(dwCommand)
{
case WFS_CMD_PIN_IMPORT_KEY: //根据不同命令保存特定数据
{
…
}
break;
case WFS_CMD_PIN_GET_PIN: //根据不同命令保存特定数据
{
…
}
break;
case WFS_CMD_PIN_GET_DATA: //根据不同命令保存特定数据
{
….
}
}break;
DWORD dwThreadId;
//将保存的数据传入线程，进行异步操作。
hThreadexcute=CreateThread(NULL,0,ExecuteMyThread,lpWFSResult,0,&dwThreadId); //异步线程
return WFS_SUCCESS;
}
异步线程实现
ExecuteMyThread(LPVOID lpParam)
{
LPWFSRESULT lpBuffer;
lpBuffer=(LPWFSRESULT)lpParam;
switch(lpBuffer->u.dwCommandCode)
{
case WFS_CMD_PIN_IMPORT_KEY:
{
…
PostMessage();//事件通知
}
Break;
case WFS_CMD_PIN_INITIALIZATION:
{
…
PostMessage();//事件通知
}
Break;
case WFS_CMD_PIN_RESET:
{
…
PostMessage();//事件通知
}
Break;
.
.
}.
}
总结：sp一般都是用dll实现，sp函数实现主要实现就是上面流程，具体是根据文档细化。文档中特别说了sp底层设备程序开发必须采用异步。即函数调用时直接给应用返回成功，具体的设备操作通过线程控制，至于设备执行是否成功，是通过postmessage事件通知应用的。
如有需要合作联系头像