poscx.h ヘッダー

[アーティクル]
11/08/2024

このヘッダーは pos によって使用されます。詳細については、以下を参照してください。

ポイントオブサービス (POS)

poscx.h には、次のプログラミングインターフェイスが含まれています。

関数


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 は、デバイスの所有権を拡張するために呼び出されます。

コールバック関数


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 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は、イベントの重要度と、クライアントアプリケーションに配信される順序を定義します。