Point of Service (POS)

ポイント オブ サービス (POS) デバイス ドライバー テクノロジの概要。

ポイント オブ サービス (POS) デバイス ドライバーを開発するには、次のヘッダーが必要です。

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

プログラミング ガイドについては、「 Point of Service (POS)」を参照してください。

IOCTL

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 列挙型は、範囲、2 つの不連続値、または任意の長さに設定するために設定できるデコード長の値を記述します。
DriverMagneticStripeReaderAuthenticationLevel この列挙体は、磁気ストライプ リーダー (MSR) 認証サポートのレベルを定義します。
DriverUnifiedPosErrorReason この列挙は、エラーの理由を示します。
DriverUnifiedPosErrorSeverity この列挙は、エラーの重大度を示します。
DriverUnifiedPosHealthCheckLevel この列挙は、POS デバイスで CheckHealthAsync が呼び出されたときに実行される正常性チェックの種類を示します。
DriverUnifiedPosPowerReportingType この列挙体は、デバイスでサポートされている電源レポートの種類を定義します (たとえば、advanced、standard など)。
DriverUnifiedPosPowerState この列挙は実装されていません。
MsrAuthenticationProtocolType この列挙は、磁気ストライプ リーダー (MSR) 認証プロトコルを定義します。
MsrCardType この列挙体は、磁気ストライプ カードの種類を定義します。
MsrDataEncryption この列挙体は、磁気ストライプ リーダー (MSR) でサポートされる暗号化アルゴリズムの種類を定義します。
MsrErrorReportingType この列挙は、磁気ストライプ リーダー (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 この列挙体は、スキャナー ドライバーと磁気ストライプ リーダー (MSR) ドライバーの IOCTL の値を定義します。
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 EVT_POS_CX_DEVICE_REMOTE_RETAIN コールバックは、PosCx がネットワーク デバイス上の要求を保持しようとするたびに呼び出され、ドライバーは追加の作業を実行できます。
POS_CX_ATTRIBUTES_INIT POS_CX_ATTRIBUTES_INITは、POS_CX_ATTRIBUTE構造体を初期化します。
PosCxClaimDevice PosCxClaimDevice は、排他的に使用するためにデバイスを要求するために呼び出されます。 デバイスが不要になった場合、呼び出し元は PosCxReleaseDevice を呼び出す必要があります。
PosCxCleanPendingRequests PosCxCleanPendingRequests は、開いているインスタンスによって識別される、特定の呼び出し元に対するすべての保留中の要求を取り消すために呼び出されます。
PosCxCleanupEvents PosCxCleanupEvents は、開いているインスタンスによって識別される、特定の呼び出し元のすべての保留中のイベントをクリーンアップするために呼び出されます。
PosCxClose 開いている PosCx ライブラリ インスタンスを削除するために、PosCxClose が呼び出されます。 呼び出し元が所有者の場合、この関数はデバイスを解放し、保留中の要求を取り消します。 これは、ドライバーの EVT_WDF_FILE_CLOSE コールバックから呼び出す必要があります。
PosCxGetDeviceInterfaceTag PosCxGetDeviceInterfaceTag は、PosCxOpen で設定されているデバイス インターフェイス タグを返します。
PosCxGetPendingEvent PosCxGetPendingEvent は、デバイスの読み取りコールバックから、または新しいイベントが到着したときに呼び出されます。
PosCxInit PosCxInit は、PosCx ライブラリの内部リソースを初期化するために呼び出されます。 リソースはデバイスに関連付けられ、デバイスが離れると解放されます。
PosCxIsDeviceOwner PosCxIsDeviceOwner は、呼び出し元が現在デバイス上の要求を所有しているかどうかを確認します。
PosCxIsPosApp PosCxIsPosApp は、開いているインスタンスがサービスポイント アプリケーションに関連付けられているかどうかを確認します。
PosCxMarkPosApp PosCxMarkPosApp は、開いているインスタンスを、サービスポイント アプリケーションに関連付けられているか関連付けられていないものとしてマークします。
PosCxOpen PosCxOpen は、開いている PosCx ライブラリ インスタンスを作成するために呼び出されます。 この関数は、1 つのオープン インスタンスを管理するために必要なすべてのリソースを初期化します。 ドライバーの 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 この構造は、Unified Point of Service (UPOS) 標準で定義され、必要とされるデバイス情報を提供します。
PosEventDataHeader この構造では、BarcodeScannerImagePreviewReceived イベントに渡されるスキャンされたイメージ データについて説明します。
PosMagneticStripeReaderCapabilitiesType この構造では、デバイスが追跡データ マスクをサポートしているかどうかなど、デバイスがサポートする磁気ストライプ リーダー (MSR) 機能の種類を定義します。
PosProfileType この構造体は、バッファー内のプロファイル文字列の数を表します。
PosStatisticsHeader この構造体は、デバイスに関する統合サービスポイント (UPOS) 標準情報を定義します。 この構造体は、受信統計のヘッダーです。
PosStatusUpdatedEventData この構造体には、StatusUpdated イベントに渡されるデータが含まれています。
PosStringType この構造体は、DataLengthInBytes の長さを持つ Point of Service (POS) Unicode 文字列を表します。
PosValueStatisticsEntry この構造体には、統計の値が含まれています。