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 EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE回呼會在 API 宣告擁有權轉換期間呼叫。 驅動程式預期會將裝置設定回此常式中的預設狀態。
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會定義事件的重要性，以及傳遞至用戶端應用程式的順序。