wosa开发、sp开发、xfs开发

一． 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事件通知应用的。 

如有需要合作联系头像