Point de service (POS)

Vue d’ensemble de la technologie de pilote de périphérique de point de service (POS).

Pour développer des pilotes de périphérique point de service (POS), vous avez besoin des en-têtes suivants :

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

Pour obtenir le guide de programmation, consultez Point de service (POS).

IOCTLs

IOCTL_POINT_OF_SERVICE_CHECK_HEALTH Cette fonction de contrôle d’E/S vérifie l’intégrité de l’appareil.
IOCTL_POINT_OF_SERVICE_CLAIM_DEVICE La fonction de contrôle d’E/S revendique l’appareil pour un accès exclusif.
IOCTL_POINT_OF_SERVICE_GET_DEVICE_BASICS Cette fonction de contrôle d’E/S obtient le type d’appareil, la version et la taille de mémoire tampon recommandée, comme spécifié par le pilote.
IOCTL_POINT_OF_SERVICE_GET_PROPERTY Cette fonction de contrôle d’E/S retourne la valeur de la propriété spécifiée à partir du pilote de périphérique.
IOCTL_POINT_OF_SERVICE_MSR_AUTHENTICATE_DEVICE Cette fonction de contrôle d’E/S authentifie le lecteur de bandes magnétiques (MSR).
IOCTL_POINT_OF_SERVICE_MSR_DEAUTHENTICATE_DEVICE Cette fonction de contrôle d’E/S déauthentifie le lecteur de bandes magnétiques (MSR).
IOCTL_POINT_OF_SERVICE_MSR_RETRIEVE_DEVICE_AUTHENTICATION Cette fonction de contrôle d’E/S récupère le type d’authentification de l’appareil.
IOCTL_POINT_OF_SERVICE_MSR_UPDATE_KEY Cette fonction de contrôle d’E/S définit une nouvelle clé de chiffrement.
IOCTL_POINT_OF_SERVICE_RELEASE_DEVICE Cette fonction de contrôle d’E/S est appelée lorsqu’un client est prêt à abandonner sa revendication sur un appareil.
IOCTL_POINT_OF_SERVICE_RESET_STATISTICS Cette fonction de contrôle d’E/S réinitialise la valeur de la statistique spécifiée à zéro.
IOCTL_POINT_OF_SERVICE_RETAIN_DEVICE Cette fonction de contrôle d’E/S est utilisée pour conserver une revendication sur un appareil lorsqu’un client est averti que sa revendication sur l’appareil est contestée par un autre client.
IOCTL_POINT_OF_SERVICE_RETRIEVE_STATISTICS Cette fonction de contrôle d’E/S retourne des informations standard upOS (Unified Point of Service) sur un appareil, telles que sa catégorie, son fabricant et son numéro de révision du microprogramme.
IOCTL_POINT_OF_SERVICE_SET_PROPERTY Cette fonction de contrôle d’E/S définit la propriété spécifiée sur l’appareil.
IOCTL_POINT_OF_SERVICE_UPDATE_STATISTICS Cette fonction de contrôle d’E/S définit la statistique spécifiée sur la valeur dans la mémoire tampon d’entrée.

Énumérations

BarcodeStatus Cette énumération indique les valeurs d’état du scanneur de codes-barres.
Code-barresSymbologie Cette énumération définit les symbologies de code-barres.
BarcodeSymbologyDecodeLengthType L’énumération BarcodeSymbologyDecodeLengthType décrit les valeurs de la longueur de décodage qui peuvent être définies pour prendre en charge une plage, deux valeurs discrètes ou être définies sur n’importe quelle longueur.
DriverMagneticStripeReaderAuthenticationLevel Cette énumération définit les niveaux de prise en charge de l’authentification msr (lecteur de bandes magnétiques).
DriverUnifiedPosErrorReason Cette énumération indique la raison de l’erreur.
DriverUnifiedPosErrorSeverity Cette énumération indique la gravité de l’erreur.
DriverUnifiedPosHealthCheckLevel Cette énumération indique le type de contrôle d’intégrité à effectuer lorsque CheckHealthAsync est appelé sur un appareil POS.
DriverUnifiedPosPowerReportingType Cette énumération définit le type de rapports d’alimentation pris en charge par l’appareil (par exemple, avancé, standard, etc.).
DriverUnifiedPosPowerState Cette énumération n’est pas implémentée.
MsrAuthenticationProtocolType Cette énumération définit les protocoles d’authentification msr (lecteur de bandes magnétiques).
MsrCardType Cette énumération définit les types de cartes à bande magnétique.
MsrDataEncryption Cette énumération définit le type d’algorithme de chiffrement pris en charge par le lecteur de bandes magnétiques (MSR).
MsrErrorReportingType Cette énumération définit les constantes qui indiquent le type de rapport d’erreurs pour le lecteur de bandes magnétiques (MSR).
MsrStatusUpdateType Cette énumération définit les constantes qui indiquent l’état du lecteur de bandes magnétiques (MSR).
MsrTrackErrorType Cette énumération définit les types d’erreurs de suivi du lecteur de bandes magnétiques.
MsrTrackIds Définit les constantes qui représentent les pistes MSR (Magnetic Stripe Reader).
MstStatisticsEntryType Cette énumération définit les types de statistiques de lecteur de bandes magnétiques.
POS_CX_EVENT_ATTRIBUTES Le POS_CX_EVENT_ATTRIBUTES décrit la priorité et les droits 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 Le POS_CX_EVENT_PRIORITY définit l’importance de l’événement et l’ordre dans lequel il sera remis à l’application cliente.
POSCXFUNCENUM Fournit la liste de toutes les fonctions d’API PosCx WDF.
PosDeviceControlType Cette énumération définit des valeurs pour les IOCTL du pilote du scanneur et du lecteur de bandes magnétiques (MSR).
PosDeviceType Cette énumération définit les valeurs utilisées dans la structure PosDeviceBasicsType pour indiquer le type d’appareil (par exemple, le scanneur de codes-barres ou le lecteur de bandes magnétiques).
PosEventType Cette énumération définit les valeurs utilisées dans la structure PosEventDataHeader pour indiquer le type d’événement qui a été déclenché.
PosPropertyId Cette énumération définit les identificateurs de propriété pour les propriétés que les pilotes de périphérique doivent gérer pour être considérés comme un scanneur de codes-barres ou un lecteur de bandes magnétiques (MSR).

Fonctions

EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE Le rappel EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE est appelé pendant la transition de la propriété des revendications d’API. Le pilote doit revenir à l’état par défaut de l’appareil dans cette routine.
EVT_POS_CX_DEVICE_REMOTE_CLAIM Le rappel EVT_POS_CX_DEVICE_REMOTE_CLAIM est appelé lorsque l’appareil passe d’un appareil non réclamé à revendiqué et permet au pilote d’effectuer un travail supplémentaire.
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, ce qui permet au pilote d’effectuer un travail supplémentaire.
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 un travail supplémentaire.
POS_CX_ATTRIBUTES_INIT POS_CX_ATTRIBUTES_INIT initialise une structure POS_CX_ATTRIBUTE.
PosCxClaimDevice PosCxClaimDevice est appelé pour revendiquer un appareil en vue d’une 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 pour un appelant donné, identifié 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 d’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 est actuellement propriétaire de 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 seule instance ouverte. 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 les 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 la mise en production de l’appareil. Cela lance la négociation de revendication.
PosCxRetainDevice PosCxRetainDevice est appelé pour étendre la propriété de l’appareil.

Structures

BarcodeSymbologyAttributesData La structure BarcodeSymbologyAttributesData contient les informations d’attribut pour une symbologie de code-barres.
MSR_AUTHENTICATE_DEVICE Cette structure fournit les informations d’authentification utilisées pour authentifier un appareil.
MSR_DATA_RECEIVED Cette structure contient les données lues à partir d’une carte à bandes magnétiques balayée.
MSR_DEAUTHENTICATE_DEVICE Cette structure fournit les informations nécessaires pour déauthentifier l’appareil.
MSR_ERROR_EVENT Cette structure contient les données d’erreur qui sont passées à l’événement MagneticStripeReaderErrorOccured.
MSR_RETRIEVE_DEVICE_AUTHENTICATION_DATA Cette structure contient des informations d’authentification récupérées à partir de l’appareil.
MSR_SUPPORTED_CARD_TYPES Cette structure définit les types de cartes à bandes magnétiques pris en charge par le lecteur.
MSR_UPDATE_KEY Cette structure contient les informations nécessaires pour définir une nouvelle clé de chiffrement.
POS_CX_ATTRIBUTES La structure POS_CX_ATTRIBUTES contient des pointeurs vers des fonctions de rappel d’événement implémentées par le pilote client.
PosBarcodeScanDataTypeData Cette structure décrit une mémoire tampon de symboles de code-barres pris en charge par le pilote.
PosBarcodeScannerCapabilitiesType Cette structure définit le type de fonctionnalités de scanneur qu’un appareil prend en charge, par exemple si l’appareil prend en charge la création de rapports de statistiques et l’aperçu d’image.
PosBarcodeScannerDataReceivedEventData Cette structure contient les données analysées qui sont passées à l’événement BarcodeScannerDataReceived.
PosBarcodeScannerErrorOccurredEventData Cette structure contient les données d’erreur qui sont passées à l’événement BarcodeScannerErrorOccurred.
PosDeviceBasicsType Cette structure indique le type de périphérique, la version et la taille de mémoire tampon recommandée, comme spécifié par le pilote.
PosDeviceInformation Cette structure fournit des informations sur les appareils telles que définies dans et requises par la norme UPOS (Unified Point of Service).
PosEventDataHeader Cette structure décrit les données d’image analysées qui sont passées à l’événement BarcodeScannerImagePreviewReceived.
PosMagneticStripeReaderCapabilitiesType Cette structure définit les types de fonctionnalités de lecteur de bandes magnétiques (MSR) prises en charge par un appareil, par exemple si l’appareil prend en charge le masquage des données de suivi.
PosProfileType Cette structure décrit le nombre de chaînes de profil dans une mémoire tampon.
PosStatisticsHeader Cette structure définit des informations standard upOS (Unified Point of Service) sur un appareil. Cette structure est l’en-tête d’une statistique entrante.
PosStatusUpdatedEventData Cette structure contient des données passées à l’événement StatusUpdated.
PosStringType Cette structure représente une chaîne Unicode point de service (POS) d’une longueur dataLengthInBytes.
PosValueStatisticsEntry Cette structure contient la valeur d’une statistique.