服務指標 (POS)

服務點 (POS) 設備磁碟機技術的概觀。

若要開發點服務點 (POS) 設備磁碟機，您需要下列標頭：

• pointofservicecommontypes.h
• pointofservicedriverinterface.h
• poscx.h
• poscxfuncenum.h

如需程式設計指南，請參閱 服務點 (POS) 。

IOCTLs

IOCTL_POINT_OF_SERVICE_CHECK_HEALTH 此 I/O 控制函式會檢查裝置健康情況。
IOCTL_POINT_OF_SERVICE_CLAIM_DEVICE I/O 控制函式會宣告裝置進行獨佔存取。
IOCTL_POINT_OF_SERVICE_GET_DEVICE_BASICS 此 I/O 控制函式會取得驅動程式所指定的裝置、版本和建議緩衝區大小類型。
IOCTL_POINT_OF_SERVICE_GET_PROPERTY 這個 I/O 控制項函式會從設備磁碟機傳回指定屬性的值。
IOCTL_POINT_OF_SERVICE_MSR_AUTHENTICATE_DEVICE 此 IO 控制函式會驗證 MSR) (磁條讀取器。
IOCTL_POINT_OF_SERVICE_MSR_DEAUTHENTICATE_DEVICE 此 I/O 控制項函式會取消驗證磁條讀取器 (MSR) 。
IOCTL_POINT_OF_SERVICE_MSR_RETRIEVE_DEVICE_AUTHENTICATION 此 I/O 控制函式會擷取裝置驗證類型。
IOCTL_POINT_OF_SERVICE_MSR_UPDATE_KEY 此 I/O 控制函式會設定新的加密金鑰。
IOCTL_POINT_OF_SERVICE_RELEASE_DEVICE 當用戶端準備好在裝置上放棄其宣告時，就會呼叫此 I/O 控制函式。
IOCTL_POINT_OF_SERVICE_RESET_STATISTICS 這個 I/O 控制項函式會將指定的統計資料值重設為零。
IOCTL_POINT_OF_SERVICE_RETAIN_DEVICE 當用戶端收到另一個用戶端在裝置上宣告的競爭通知時，這個 I/O 控制函式可用來在裝置上保留宣告。
IOCTL_POINT_OF_SERVICE_RETRIEVE_STATISTICS 此 I/O 控制函式會傳回 UPOS (統一的服務點，) 裝置的標準資訊，例如其類別、製造商和韌體修訂編號。
IOCTL_POINT_OF_SERVICE_SET_PROPERTY 此 I/O 控制項函式會在裝置上設定指定的屬性。
IOCTL_POINT_OF_SERVICE_UPDATE_STATISTICS 這個 I/O 控制項函式會將指定的統計資料設定為輸入緩衝區中的值。

列舉

BarcodeStatus 這個列舉表示條碼掃描器狀態值。
BarcodeSymbology 這個列舉會定義條碼符號。
BarcodeSymbologyDecodeLengthType BarcodeSymbologyDecodeLengthType 列舉描述可設定為支援範圍、兩個離散值或設定為任何長度的解碼長度值。
DriverMagneticStripeReaderAuthenticationLevel 此列舉定義 MSR) 驗證支援的磁帶讀取器層級 (。
DriverUnifiedPosErrorReason 這個列舉表示錯誤的原因。
DriverUnifiedPosErrorSeverity 這個列舉表示錯誤的嚴重性。
DriverUnifiedPosHealthCheckLevel 此列舉表示在 POS 裝置上呼叫 CheckHealthAsync 時要執行的健康情況檢查類型。
DriverUnifiedPosPowerReportingType 此列舉定義裝置 (所支援的電源報告類型，例如進階、標準等) 。
DriverUnifiedPosPowerState 未實作這個列舉。
MsrAuthenticationProtocolType 此列舉定義 MSR) 驗證通訊協定 (磁條讀取器。
MsrCardType 此列舉定義磁條卡的類型。
MsrDataEncryption 此列舉定義磁片帶讀取器 (MSR) 支援的加密演算法類型。
MsrErrorReportingType 此列舉會定義常數，指出 MSR 讀取器 (MSR) 的錯誤報表類型。
MsrStatusUpdateType 此列舉會定義常數，指出磁條讀取器 (MSR) 狀態。
MsrTrackErrorType 此列舉定義磁條讀取器追蹤錯誤的種類。
MsrTrackIds 定義常數，這些常數代表 MSR) 追蹤 (磁條讀取器。
MstStatisticsEntryType 此列舉定義磁條讀取器統計資料的類型。
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會定義事件的重要性，以及傳遞至用戶端應用程式的順序。
POSCXFUNCENUM 提供所有 PosCx WDF API 函式的清單。
PosDeviceControlType 此列舉定義掃描器驅動程式的 IOCTL 值，以及 MSR) 驅動程式 (磁帶讀取器的值。
PosDeviceType 此列舉定義 PosDeviceBasicsType 結構中使用的值，以指出例如條碼掃描器或磁條讀取器) 的裝置 (類型。
PosEventType 此列舉定義 PosEventDataHeader 結構中使用的值，以指出引發的事件種類。
PosPropertyId 此列舉會定義設備磁碟機需要處理的屬性識別碼，以視為條碼掃描器或磁片區讀取器 (MSR) 。

函式

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_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 來擴充裝置的擁有權。

結構

BarcodeSymbologyAttributesData BarcodeSymbologyAttributesData 結構包含條碼符號系統的屬性資訊。
MSR_AUTHENTICATE_DEVICE 此結構提供用來驗證裝置的驗證資訊。
MSR_DATA_RECEIVED 這個結構包含從撥動磁帶卡片讀取的資料。
MSR_DEAUTHENTICATE_DEVICE 此結構提供解除驗證裝置所需的資訊。
MSR_ERROR_EVENT 這個結構包含傳遞至 MagneticStripeReaderErrorOccured 事件的錯誤資料。
MSR_RETRIEVE_DEVICE_AUTHENTICATION_DATA 這個結構包含從裝置擷取的驗證資訊。
MSR_SUPPORTED_CARD_TYPES 此結構會定義讀取器所支援的磁帶卡片類型。
MSR_UPDATE_KEY 此結構包含設定新加密金鑰所需的資訊。
POS_CX_ATTRIBUTES POS_CX_ATTRIBUTES 結構包含用戶端驅動程式所實作之事件回呼函式的指標。
PosBarcodeScanDataTypeData 此結構描述驅動程式支援的條碼符號系統緩衝區。
PosBarcodeScannerCapabilitiesType 此結構會定義裝置支援的掃描器功能類型，例如裝置是否支援統計資料包告和影像預覽。
PosBarcodeScannerDataReceivedEventData 這個結構包含傳遞至 BarcodeScannerDataReceived 事件的掃描資料。
PosBarcodeScannerErrorOccurredEventData 這個結構包含傳遞至 BarcodeScannerErrorOccurred 事件的錯誤資料。
PosDeviceBasicsType 這個結構表示驅動程式所指定的裝置、版本和建議的緩衝區大小類型。
PosDeviceInformation 此結構提供統一服務點 (UPOS) 標準所定義和所需的裝置資訊。
PosEventDataHeader 此結構描述傳遞至 BarcodeScannerImagePreviewReceived 事件的掃描影像資料。
PosMagneticStripeReaderCapabilitiesType 此結構會定義裝置支援的磁帶讀取器種類 (MSR) 功能，例如裝置是否支援追蹤資料遮罩。
PosProfileType 這個結構描述緩衝區中的設定檔字串數目。
PosStatisticsHeader 此結構會定義整合服務點 (UPOS) 裝置的標準資訊。 這個結構是傳入統計資料的標頭。
PosStatusUpdatedEventData 此結構包含傳遞至 StatusUpdated 事件的資料。
PosStringType 這個結構代表具有 DataLengthInBytes 長度的 POS) unicode 字串 (點服務點。
PosValueStatisticsEntry 這個結構包含統計資料的值。