poscx.h 标头

此标头由 pos 使用。有关详细信息，请参阅：

• 服务点（POS）

poscx.h 包含以下编程接口：

功能

POS_CX_ATTRIBUTES_INIT POS_CX_ATTRIBUTES_INIT初始化POS_CX_ATTRIBUTE结构。
PosCxClaimDevice 将调用 PosCxClaimDevice 来声明设备以供独占使用。 当不再需要设备时，调用方应调用 PosCxReleaseDevice。
PosCxCleanPendingRequests 调用 PosCxCleanPendingRequests 以取消由打开实例标识的给定调用方的所有挂起请求。
PosCxCleanupEvents 调用 PosCxCleanupEvents 以清理由打开实例标识的给定调用方的所有挂起事件。
PosCxClose 调用 PosCxClose 以删除打开的 PosCx 库实例。 如果调用方是所有者，并且取消挂起的请求，则此函数会释放设备。 它应从驱动程序的EVT_WDF_FILE_CLOSE回调调用。
PosCxGetDeviceInterfaceTag PosCxGetDeviceInterfaceTag 返回在 PosCxOpen 中设置的设备接口标记。
PosCxGetPendingEvent PosCxGetPendingEvent 是从设备读取回调调用的，或者在新事件到达时调用。
PosCxInit 调用 PosCxInit 以初始化 PosCx 库的内部资源。 资源绑定到设备，并在设备消失时释放。
PosCxIsDeviceOwner PosCxIsDeviceOwner 检查调用方当前是否拥有设备上的声明。
PosCxIsPosApp PosCxIsPosApp 检查打开的实例是否与服务点应用程序相关联。
PosCxMarkPosApp PosCxMarkPosApp 将打开的实例标记为与服务点应用程序关联或不关联。
PosCxOpen 调用 PosCxOpen 以创建一个打开的 PosCx 库实例。 此函数初始化管理单个打开实例所需的所有资源。 它应从驱动程序的EVT_WDF_DEVICE_FILE_CREATE回调调用。
PosCxPutPendingEvent PosCxPutPendingEvent 创建新的事件对象，将事件数据复制到新的事件对象，并尝试将其委托给等待调用方。
PosCxPutPendingEventMemory PosCxPutPendingEventMemory 尝试将包含事件数据的内存对象委托给等待调用方。
PosCxReleaseDevice 将调用 PosCxReleaseDevice 释放以前使用 PosCxClaimDevice 声明的设备。 释放设备后，将提升下一个挂起的声明请求者。
PosCxRemoteRequestRelease 每当远程设备要求设备释放时，都调用 PosCxRemoteRequestRelease。 这会启动声明协商。
PosCxRetainDevice 调用 PosCxRetainDevice 以扩展设备的所有权。

回调函数

EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE 在 API 声明所有权转换期间调用EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE回调。 驱动程序应将此例程中的设备重新设置为默认状态。
EVT_POS_CX_DEVICE_REMOTE_CLAIM 当设备从未认领转换到声明时，将调用EVT_POS_CX_DEVICE_REMOTE_CLAIM回调，并允许驱动程序执行其他工作。
EVT_POS_CX_DEVICE_REMOTE_RELEASE 每当设备释放并离开时，将调用EVT_POS_CX_DEVICE_REMOTE_RELEASE回调，没有所有者，并允许驱动程序执行其他工作。
EVT_POS_CX_DEVICE_REMOTE_RETAIN 每当 PosCx 尝试在网络设备上保留声明并允许驱动程序执行其他工作时，将调用EVT_POS_CX_DEVICE_REMOTE_RETAIN回调。

结构

POS_CX_ATTRIBUTES POS_CX_ATTRIBUTES结构包含指向客户端驱动程序实现的事件回调函数的指针。

枚举

POS_CX_EVENT_ATTRIBUTES POS_CX_EVENT_ATTRIBUTES描述了来自设备的 POS 事件的优先级和访问权限。 这些值是POS_CX_EVENT_DEST和POS_CX_EVENT_PRIORITY中定义的值的组合。
POS_CX_EVENT_DEST POS_CX_EVENT_DEST定义接收此事件的应用程序。
POS_CX_EVENT_PRIORITY POS_CX_EVENT_PRIORITY定义事件的重要性及其将传递到客户端应用程序的顺序。