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定义事件的重要性以及事件传递给客户端应用程序的顺序。