en-tête poscx.h

Cet en-tête est utilisé par pos. Pour plus d’informations, consultez :

• point de service (POS)

poscx.h contient les interfaces de programmation suivantes :

Fonctions

POS_CX_ATTRIBUTES_INIT POS_CX_ATTRIBUTES_INIT initialise une structure de POS_CX_ATTRIBUTE.
PosCxClaimDevice PosCxClaimDevice est appelé pour revendiquer un appareil à des fins d’utilisation exclusive. L’appelant doit appeler PosCxReleaseDevice lorsque l’appareil n’est plus nécessaire.
PosCxCleanPendingRequests PosCxCleanPendingRequests est appelé pour annuler toutes les demandes en attente d’un appelant donné, identifiée par l’instance ouverte.
PosCxCleanupEvents PosCxCleanupEvents est appelé pour nettoyer tous les événements en attente pour un appelant donné, identifié par l’instance ouverte.
PosCxClose PosCxClose est appelé pour supprimer une instance de bibliothèque PosCx ouverte. Cette fonction libère l’appareil si l’appelant est le propriétaire et annule les demandes en attente. Il doit être appelé à partir du rappel EVT_WDF_FILE_CLOSE du pilote.
PosCxGetDeviceInterfaceTag PosCxGetDeviceInterfaceTag retourne la balise d’interface de l’appareil définie dans PosCxOpen.
PosCxGetPendingEvent PosCxGetPendingEvent est appelé à partir du rappel de lecture de l’appareil ou lorsqu’un nouvel événement arrive.
PosCxInit PosCxInit est appelé pour initialiser les ressources internes de la bibliothèque PosCx. Les ressources sont liées à l’appareil et sont libérées lorsque l’appareil disparaît.
PosCxIsDeviceOwner PosCxIsDeviceOwner vérifie si l’appelant possède actuellement la revendication sur l’appareil.
PosCxIsPosApp PosCxIsPosApp vérifie si l’instance ouverte est associée à une application de point de service.
PosCxMarkPosApp PosCxMarkPosApp marque l’instance ouverte comme associée ou non associée à une application de point de service.
PosCxOpen PosCxOpen est appelé pour créer une instance de bibliothèque PosCx ouverte. Cette fonction initialise toutes les ressources dont elle a besoin pour gérer une instance ouverte unique. Il doit être appelé à partir du rappel EVT_WDF_DEVICE_FILE_CREATE du pilote.
PosCxPutPendingEvent PosCxPutPendingEvent crée un objet d’événement, copie les données d’événement dans le nouvel objet d’événement et tente de le déléguer à l’appelant en attente.
PosCxPutPendingEventMemory PosCxPutPendingEventMemory tente de déléguer un objet mémoire contenant les données d’événement à un appelant en attente.
PosCxReleaseDevice PosCxReleaseDevice est appelé pour libérer un appareil précédemment revendiqué avec PosCxClaimDevice. Une fois l’appareil libéré, le demandeur de revendication en attente suivant est promu.
PosCxRemoteRequestRelease PosCxRemoteRequestRelease est appelé chaque fois qu’un appareil distant demande à l’appareil de libérer l’appareil. Cela lance la négociation des revendications.
PosCxRetainDevice PosCxRetainDevice est appelé pour étendre la propriété de l’appareil.

Fonctions de rappel

EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE Le rappel EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE est appelé pendant la transition de propriété de revendication d’API. Le pilote est censé remettre l’appareil à un état par défaut dans cette routine.
EVT_POS_CX_DEVICE_REMOTE_CLAIM Le rappel EVT_POS_CX_DEVICE_REMOTE_CLAIM est appelé lorsque l’appareil passe d’une revendication non revendiquée et permet au pilote d’effectuer des tâches supplémentaires.
EVT_POS_CX_DEVICE_REMOTE_RELEASE Le rappel EVT_POS_CX_DEVICE_REMOTE_RELEASE est appelé chaque fois que l’appareil est libéré et laissé sans propriétaire et permet au pilote d’effectuer des tâches supplémentaires.
EVT_POS_CX_DEVICE_REMOTE_RETAIN Le rappel EVT_POS_CX_DEVICE_REMOTE_RETAIN est appelé chaque fois que PosCx tente de conserver une revendication sur un périphérique réseau et permet au pilote d’effectuer des tâches supplémentaires.

Structures

POS_CX_ATTRIBUTES La structure POS_CX_ATTRIBUTES contient des pointeurs vers des fonctions de rappel d’événements implémentées par le pilote client.

Énumérations

POS_CX_EVENT_ATTRIBUTES Le POS_CX_EVENT_ATTRIBUTES décrit les droits de priorité et d’accès pour les événements POS provenant de l’appareil. Les valeurs sont une combinaison des valeurs définies dans POS_CX_EVENT_DEST et POS_CX_EVENT_PRIORITY.
POS_CX_EVENT_DEST Le POS_CX_EVENT_DEST définit les applications qui reçoivent cet événement.
POS_CX_EVENT_PRIORITY La POS_CX_EVENT_PRIORITY définit l’importance de l’événement et la commande qu’elle sera remise à l’application cliente.