poscx.h-Header

Diese Kopfzeile wird von Pos verwendet. Weitere Informationen finden Sie unter:

• Point of Service (POS)

poscx.h enthält die folgenden Programmierschnittstellen:

Funktionen

POS_CX_ATTRIBUTES_INIT POS_CX_ATTRIBUTES_INIT initialisiert eine POS_CX_ATTRIBUTE Struktur.
PosCxClaimDevice PosCxClaimDevice wird aufgerufen, um ein Gerät zur exklusiven Verwendung zu beanspruchen. Der Anrufer sollte PosCxReleaseDevice aufrufen, wenn das Gerät nicht mehr benötigt wird.
PosCxCleanPendingRequests PosCxCleanPendingRequests wird aufgerufen, um alle ausstehenden Anforderungen für einen bestimmten Aufrufer abzubrechen, der von der geöffneten Instanz identifiziert wird.
PosCxCleanupEvents PosCxCleanupEvents wird aufgerufen, um alle ausstehenden Ereignisse für einen bestimmten Aufrufer zu bereinigen, der von der geöffneten Instanz identifiziert wird.
PosCxClose PosCxClose wird aufgerufen, um eine geöffnete PosCx-Bibliotheksinstanz zu löschen. Diese Funktion gibt das Gerät frei, wenn der Aufrufer der Besitzer ist, und bricht ausstehende Anforderungen ab. Er sollte vom EVT_WDF_FILE_CLOSE Rückruf des Treibers aufgerufen werden.
PosCxGetDeviceInterfaceTag- PosCxGetDeviceInterfaceTag gibt das Geräteschnittstellentag zurück, das in PosCxOpen festgelegt ist.
PosCxGetPendingEvent- PosCxGetPendingEvent wird entweder über den Geräteleserückruf aufgerufen oder wenn ein neues Ereignis eingeht.
PosCxInit- PosCxInit wird aufgerufen, um die internen Ressourcen der PosCx-Bibliothek zu initialisieren. Die Ressourcen sind an das Gerät gebunden und werden freigegeben, wenn das Gerät weggeht.
PosCxIsDeviceOwner PosCxIsDeviceOwner überprüft, ob der Aufrufer derzeit den Anspruch auf dem Gerät besitzt.
PosCxIsPosApp- PosCxIsPosApp überprüft, ob die geöffnete Instanz einer Point-of-Service-Anwendung zugeordnet ist.
PosCxMarkPosApp PosCxMarkPosApp markiert die geöffnete Instanz als zugeordnet oder nicht mit einer Point-of-Service-Anwendung verknüpft.
PosCxOpen PosCxOpen wird aufgerufen, um eine geöffnete PosCx-Bibliotheksinstanz zu erstellen. Diese Funktion initialisiert alle Ressourcen, die zum Verwalten einer einzelnen geöffneten Instanz erforderlich sind. Es sollte vom EVT_WDF_DEVICE_FILE_CREATE Rückruf des Treibers aufgerufen werden.
PosCxPutPendingEvent PosCxPutPendingEvent erstellt ein neues Ereignisobjekt, kopiert die Ereignisdaten in das neue Ereignisobjekt und versucht, es an den Warteaufrufer zu delegieren.
PosCxPutPendingEventMemory PosCxPutPendingEventMemory versucht, ein Speicherobjekt mit den Ereignisdaten an einen Warteaufrufer zu delegieren.
PosCxReleaseDevice PosCxReleaseDevice wird aufgerufen, um ein Gerät freizugeben, das zuvor mit PosCxClaimDevice beansprucht wurde. Nachdem das Gerät freigegeben wurde, wird der nächste ausstehende Anspruchsanforderunger heraufgestuft.
PosCxRemoteRequestRelease PosCxRemoteRequestRelease wird immer aufgerufen, wenn ein Remotegerät aufgefordert wird, das Gerät freizugeben. Dadurch wird die Forderungsverhandlung initiiert.
PosCxRetainDevice PosCxRetainDevice wird aufgerufen, um den Besitz des Geräts zu erweitern.

Rückruffunktionen

EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE Der EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE Rückruf wird während des API-Anspruchsbesitzübergangs aufgerufen. Der Treiber wird erwartet, dass das Gerät in dieser Routine auf einen Standardzustand zurückgesetzt wird.
EVT_POS_CX_DEVICE_REMOTE_CLAIM Der EVT_POS_CX_DEVICE_REMOTE_CLAIM Rückruf wird aufgerufen, wenn das Gerät von "nicht beansprucht" auf "beansprucht" umgestellt wird und dem Treiber zusätzliche Arbeit ermöglicht.
EVT_POS_CX_DEVICE_REMOTE_RELEASE Der EVT_POS_CX_DEVICE_REMOTE_RELEASE Rückruf wird immer aufgerufen, wenn das Gerät losgelassen und ohne Besitzer übrig bleibt und dem Treiber ermöglicht, zusätzliche Aufgaben zu erledigen.
EVT_POS_CX_DEVICE_REMOTE_RETAIN Der EVT_POS_CX_DEVICE_REMOTE_RETAIN Rückruf wird immer aufgerufen, wenn PosCx versucht, einen Anspruch auf einem Netzwerkgerät zu halten und dem Treiber zusätzliche Arbeit zu ermöglichen.

Strukturen

POS_CX_ATTRIBUTES Die POS_CX_ATTRIBUTES-Struktur enthält Zeiger auf Ereignisrückruffunktionen, die vom Clienttreiber implementiert werden.

Aufzählungen

POS_CX_EVENT_ATTRIBUTES Die POS_CX_EVENT_ATTRIBUTES beschreibt die Prioritäts- und Zugriffsrechte für die POS-Ereignisse, die vom Gerät stammen. Die Werte sind eine Kombination der in POS_CX_EVENT_DEST und POS_CX_EVENT_PRIORITY definierten Werte.
POS_CX_EVENT_DEST Die POS_CX_EVENT_DEST definiert, welche Anwendungen dieses Ereignis empfangen.
POS_CX_EVENT_PRIORITY Die POS_CX_EVENT_PRIORITY definiert die Wichtigkeit des Ereignisses und die Reihenfolge, die sie an die Clientanwendung übermittelt wird.