Punto de servicio (POS)

Información general sobre la tecnología de controladores de dispositivos de punto de servicio (POS).

Para desarrollar controladores de dispositivos de punto de servicio (POS), necesita estos encabezados:

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

Para obtener la guía de programación, consulte Punto de servicio (POS).

IOCTL

IOCTL_POINT_OF_SERVICE_CHECK_HEALTH Esta función de control de E/S comprueba el estado del dispositivo.
IOCTL_POINT_OF_SERVICE_CLAIM_DEVICE La función de control de E/S reclama el dispositivo para el acceso exclusivo.
IOCTL_POINT_OF_SERVICE_GET_DEVICE_BASICS Esta función de control de E/S obtiene el tipo de dispositivo, versión y tamaño de búfer recomendado según lo especificado por el controlador.
IOCTL_POINT_OF_SERVICE_GET_PROPERTY Esta función de control de E/S devuelve el valor de la propiedad especificada del controlador de dispositivo.
IOCTL_POINT_OF_SERVICE_MSR_AUTHENTICATE_DEVICE Esta función de control de E/S autentica el lector de bandas magnéticas (MSR).
IOCTL_POINT_OF_SERVICE_MSR_DEAUTHENTICATE_DEVICE Esta función de control de E/S desautoriza el lector de bandas magnéticas (MSR).
IOCTL_POINT_OF_SERVICE_MSR_RETRIEVE_DEVICE_AUTHENTICATION Esta función de control de E/S recupera el tipo de autenticación del dispositivo.
IOCTL_POINT_OF_SERVICE_MSR_UPDATE_KEY Esta función de control de E/S establece una nueva clave de cifrado.
IOCTL_POINT_OF_SERVICE_RELEASE_DEVICE Se llama a esta función de control de E/S cuando un cliente está listo para renunciar a su notificación en un dispositivo.
IOCTL_POINT_OF_SERVICE_RESET_STATISTICS Esta función de control de E/S restablece el valor de la estadística especificada a cero.
IOCTL_POINT_OF_SERVICE_RETAIN_DEVICE Esta función de control de E/S se usa para mantener una notificación en un dispositivo cuando se notifica a un cliente que su reclamación en el dispositivo está siendo impugnada por otro cliente.
IOCTL_POINT_OF_SERVICE_RETRIEVE_STATISTICS Esta función de control de E/S devuelve información estándar de punto de servicio unificado (UPOS) sobre un dispositivo como su categoría, fabricante y número de revisión de firmware.
IOCTL_POINT_OF_SERVICE_SET_PROPERTY Esta función de control de E/S establece la propiedad especificada en el dispositivo.
IOCTL_POINT_OF_SERVICE_UPDATE_STATISTICS Esta función de control de E/S establece la estadística especificada en el valor del búfer de entrada.

Enumeraciones

BarcodeStatus Esta enumeración indica los valores de estado del escáner de códigos de barras.
BarcodeSymbology Esta enumeración define las simbologías de código de barras.
BarcodeSymbologyDecodeLengthType La enumeración BarcodeSymbologyDecodeLengthType describe los valores de la longitud de descodificación que se puede establecer para admitir un intervalo, dos valores discretos o establecerse en cualquier longitud.
DriverMagneticStripeReaderAuthenticationLevel Esta enumeración define los niveles de compatibilidad con la autenticación del lector de bandas magnéticas (MSR).
DriverUnifiedPosErrorReason Esta enumeración indica el motivo del error.
DriverUnifiedPosErrorSeverity Esta enumeración indica la gravedad del error.
DriverUnifiedPosHealthCheckLevel Esta enumeración indica el tipo de comprobación de estado que se va a realizar cuando se llama a CheckHealthAsync en un dispositivo POS.
DriverUnifiedPosPowerReportingType Esta enumeración define el tipo de informes de energía admitidos por el dispositivo (por ejemplo, avanzados, estándar, etc.).
DriverUnifiedPosPowerState Esta enumeración no se implementa.
MsrAuthenticationProtocolType Esta enumeración define protocolos de autenticación del lector de bandas magnéticas (MSR).
MsrCardType Esta enumeración define los tipos de tarjetas de franja magnética.
MsrDataEncryption Esta enumeración define el tipo de algoritmo de cifrado admitido por el lector de bandas magnéticas (MSR).
MsrErrorReportingType Esta enumeración define las constantes que indican el tipo de informe de errores para el lector de bandas magnéticas (MSR).
MsrStatusUpdateType Esta enumeración define las constantes que indican el estado del lector de bandas magnéticas (MSR).
MsrTrackErrorType Esta enumeración define los tipos de errores de seguimiento del lector de bandas magnéticas.
MsrTrackIds Define las constantes que representan las pistas del lector de bandas magnéticas (MSR).
MstStatisticsEntryType Esta enumeración define los tipos de estadísticas de lector de bandas magnéticas.
POS_CX_EVENT_ATTRIBUTES En el POS_CX_EVENT_ATTRIBUTES se describen los derechos de prioridad y acceso para los eventos pos procedentes del dispositivo. Los valores son una combinación de los valores definidos en POS_CX_EVENT_DEST y POS_CX_EVENT_PRIORITY.
POS_CX_EVENT_DEST El POS_CX_EVENT_DEST define qué aplicaciones reciben este evento.
POS_CX_EVENT_PRIORITY El POS_CX_EVENT_PRIORITY define la importancia del evento y el orden en que se entregará a la aplicación cliente.
POSCXFUNCENUM Proporciona una lista de todas las funciones de api de WDF posCx.
PosDeviceControlType Esta enumeración define los valores de las ICTL del controlador del escáner y del controlador de lector de bandas magnéticas (MSR).
PosDeviceType Esta enumeración define los valores usados en la estructura PosDeviceBasicsType para indicar el tipo de dispositivo (por ejemplo, escáner de códigos de barras o lector de bandas magnéticas).
PosEventType Esta enumeración define los valores usados en la estructura PosEventDataHeader para indicar el tipo de evento que se generó.
PosPropertyId Esta enumeración define los identificadores de propiedad de las propiedades que los controladores de dispositivos deben controlar para considerarse un escáner de códigos de barras o un lector de bandas magnéticas (MSR).

Functions

EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE Se llama a la devolución de llamada EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE durante la transición de la propiedad de la notificación de API. Se espera que el controlador vuelva a establecer el dispositivo en un estado predeterminado en esta rutina.
EVT_POS_CX_DEVICE_REMOTE_CLAIM Se llama a la EVT_POS_CX_DEVICE_REMOTE_CLAIM devolución de llamada cuando el dispositivo pasa de no reclamado a reclamado y permite al controlador realizar un trabajo adicional.
EVT_POS_CX_DEVICE_REMOTE_RELEASE Se llama a la devolución de llamada EVT_POS_CX_DEVICE_REMOTE_RELEASE cada vez que el dispositivo se libera y deja sin propietario y permite al controlador realizar trabajo adicional.
EVT_POS_CX_DEVICE_REMOTE_RETAIN Se llama a la devolución de llamada EVT_POS_CX_DEVICE_REMOTE_RETAIN cada vez que PosCx intenta mantener una notificación en un dispositivo de red y permite al controlador realizar un trabajo adicional.
POS_CX_ATTRIBUTES_INIT POS_CX_ATTRIBUTES_INIT inicializa una estructura de POS_CX_ATTRIBUTE.
PosCxClaimDevice Se llama a PosCxClaimDevice para reclamar un dispositivo para uso exclusivo. El llamador debe llamar a PosCxReleaseDevice cuando el dispositivo ya no sea necesario.
PosCxCleanPendingRequests Se llama a PosCxCleanPendingRequests para cancelar todas las solicitudes pendientes de un llamador determinado, identificado por la instancia abierta.
PosCxCleanupEvents Se llama a PosCxCleanupEvents para limpiar todos los eventos pendientes de un llamador determinado, identificado por la instancia abierta.
PosCxClose Se llama a PosCxClose para eliminar una instancia de biblioteca posCx abierta. Esta función libera el dispositivo si el autor de la llamada es el propietario y cancela las solicitudes pendientes. Se debe llamar desde la devolución de llamada EVT_WDF_FILE_CLOSE del controlador.
PosCxGetDeviceInterfaceTag PosCxGetDeviceInterfaceTag devuelve la etiqueta de interfaz de dispositivo establecida en PosCxOpen.
PosCxGetPendingEvent Se llama a PosCxGetPendingEvent desde la devolución de llamada de lectura del dispositivo o cuando llega un nuevo evento.
PosCxInit Se llama a PosCxInit para inicializar los recursos internos de la biblioteca posCx. Los recursos están vinculados al dispositivo y se liberan cuando el dispositivo desaparece.
PosCxIsDeviceOwner PosCxIsDeviceOwner comprueba si el autor de la llamada posee actualmente la notificación en el dispositivo.
PosCxIsPosApp PosCxIsPosApp comprueba si la instancia abierta está asociada a una aplicación de punto de servicio.
PosCxMarkPosApp PosCxMarkPosApp marca la instancia abierta como asociada o no asociada a una aplicación de punto de servicio.
PosCxOpen Se llama a PosCxOpen para crear una instancia de biblioteca posCx abierta. Esta función inicializa todos los recursos que necesita para administrar una única instancia abierta. Se debe llamar desde la devolución de llamada EVT_WDF_DEVICE_FILE_CREATE del controlador.
PosCxPutPendingEvent PosCxPutPendingEvent crea un nuevo objeto de evento, copia los datos del evento en el nuevo objeto de evento e intenta delegarlos en el llamador en espera.
PosCxPutPendingEventMemory PosCxPutPendingEventMemory intenta delegar un objeto de memoria que contiene los datos del evento en un llamador en espera.
PosCxReleaseDevice Se llama a PosCxReleaseDevice para liberar un dispositivo que se afirmó anteriormente con PosCxClaimDevice. Una vez liberado el dispositivo, se promueve el siguiente solicitante de notificaciones pendiente.
PosCxRemoteRequestRelease Se llama a PosCxRemoteRequestRelease cada vez que un dispositivo remoto solicita que el dispositivo se suelte. Esto inicia la negociación de notificaciones.
PosCxRetainDevice Se llama a PosCxRetainDevice para ampliar la propiedad del dispositivo.

Estructuras

BarcodeSymbologyAttributesData La estructura BarcodeSymbologyAttributesData contiene la información de atributo de una simbología de código de barras.
MSR_AUTHENTICATE_DEVICE Esta estructura proporciona la información de autenticación usada para autenticar un dispositivo.
MSR_DATA_RECEIVED Esta estructura contiene los datos leídos de una tarjeta de franja magnética deslizada.
MSR_DEAUTHENTICATE_DEVICE Esta estructura proporciona la información necesaria para desautenticar el dispositivo.
MSR_ERROR_EVENT Esta estructura contiene los datos de error que se pasan al evento MagneticStripeReaderErrorOccured.
MSR_RETRIEVE_DEVICE_AUTHENTICATION_DATA Esta estructura contiene información de autenticación recuperada del dispositivo.
MSR_SUPPORTED_CARD_TYPES Esta estructura define los tipos de tarjetas de franja magnética compatibles con el lector.
MSR_UPDATE_KEY Esta estructura contiene la información necesaria para establecer una nueva clave de cifrado.
POS_CX_ATTRIBUTES La estructura de POS_CX_ATTRIBUTES contiene punteros a las funciones de devolución de llamada de eventos implementadas por el controlador de cliente.
PosBarcodeScanDataTypeData Esta estructura describe un búfer de simbologías de código de barras compatibles con el controlador.
PosBarcodeScannerCapabilitiesType Esta estructura define el tipo de funcionalidades del analizador que admite un dispositivo, como si el dispositivo admite informes de estadísticas y vista previa de imágenes.
PosBarcodeScannerDataReceivedEventData Esta estructura contiene los datos examinados que se pasan al evento BarcodeScannerDataReceived.
PosBarcodeScannerErrorOccurredEventData Esta estructura contiene los datos de error que se pasan al evento BarcodeScannerErrorOccurred.
PosDeviceBasicsType Esta estructura indica el tipo de dispositivo, versión y tamaño de búfer recomendado según lo especificado por el controlador.
PosDeviceInformation Esta estructura proporciona información del dispositivo tal como se define en y requiere el estándar Unified Point of Service (UPOS).
PosEventDataHeader Esta estructura describe los datos de imagen escaneados que se pasan al evento BarcodeScannerImagePreviewReceived.
PosMagneticStripeReaderCapabilitiesType Esta estructura define los tipos de funcionalidades de lector de bandas magnéticas (MSR) que admite un dispositivo, como si el dispositivo admite el enmascaramiento de datos de seguimiento.
PosProfileType Esta estructura describe el número de cadenas de perfil en un búfer.
PosStatisticsHeader Esta estructura define información estándar del punto de servicio unificado (UPOS) sobre un dispositivo. Esta estructura es el encabezado de una estadística entrante.
PosStatusUpdatedEventData Esta estructura contiene datos pasados al evento StatusUpdated.
PosStringType Esta estructura representa una cadena unicode de punto de servicio (POS) con una longitud de DataLengthInBytes.
PosValueStatisticsEntry Esta estructura contiene el valor de una estadística.