Точка обслуживания (POS)

Обзор технологии драйвера устройств point of Service (POS).

Для разработки драйверов устройств point of Service (POS) вам потребуется следующее:

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

Руководство по программированию см. в разделе "Точка обслуживания( POS)".

IoCTLs

IOCTL_POINT_OF_SERVICE_CHECK_HEALTH Эта функция управления ввода-вывода проверяет работоспособность устройства.
IOCTL_POINT_OF_SERVICE_CLAIM_DEVICE Функция управления ввода-вывода утверждает устройство для эксклюзивного доступа.
IOCTL_POINT_OF_SERVICE_GET_DEVICE_BASICS Эта функция управления ввода-вывода получает тип устройства, версии и рекомендуемый размер буфера, указанный драйвером.
IOCTL_POINT_OF_SERVICE_GET_PROPERTY Эта функция управления ввода-вывода возвращает значение указанного свойства из драйвера устройства.
IOCTL_POINT_OF_SERVICE_MSR_AUTHENTICATE_DEVICE Эта функция управления ввода-вывода проверяет подлинность средства чтения магнитной полосы (MSR).
IOCTL_POINT_OF_SERVICE_MSR_DEAUTHENTICATE_DEVICE Эта функция управления ввода-вывода отменяет проверку подлинности средства чтения магнитной полосы (MSR).
IOCTL_POINT_OF_SERVICE_MSR_RETRIEVE_DEVICE_AUTHENTICATION Эта функция управления ввода-вывода извлекает тип проверки подлинности устройства.
IOCTL_POINT_OF_SERVICE_MSR_UPDATE_KEY Эта функция управления ввода-вывода задает новый ключ шифрования.
IOCTL_POINT_OF_SERVICE_RELEASE_DEVICE Эта функция управления ввода-вывода вызывается, когда клиент готов отказаться от утверждения на устройстве.
IOCTL_POINT_OF_SERVICE_RESET_STATISTICS Эта функция управления ввода-вывода сбрасывает значение указанной статистики до нуля.
IOCTL_POINT_OF_SERVICE_RETAIN_DEVICE Эта функция управления ввода-вывода используется для сохранения утверждения на устройстве, когда клиент уведомляется о том, что его утверждение на устройстве оспаривается другим клиентом.
IOCTL_POINT_OF_SERVICE_RETRIEVE_STATISTICS Эта функция управления ввода-вывода возвращает стандартную стандартную информацию об устройстве, например о его категории, изготовителе и номере редакции встроенного ПО.
IOCTL_POINT_OF_SERVICE_SET_PROPERTY Эта функция управления ввода-вывода задает указанное свойство на устройстве.
IOCTL_POINT_OF_SERVICE_UPDATE_STATISTICS Эта функция управления ввода-вывода задает указанной статистике значение в входном буфере.

Перечисления

BarcodeStatus Это перечисление указывает значения состояния сканера штрихкодов.
ШтрихкодSymbology Это перечисление определяет символы штрихкода.
BarcodeSymbologyDecodeLengthType Перечисление BarcodeSymbologyDecodeLengthType описывает значения для длины декодировки, которую можно задать для поддержки диапазона, двух дискретных значений или для любой длины.
DriverMagneticStripeReaderAuthenticationLevel Это перечисление определяет уровни поддержки проверки подлинности магнитной полосы (MSR).
DriverUnifiedPosErrorReason Это перечисление указывает причину ошибки.
DriverUnifiedPosErrorSeverity Это перечисление указывает на серьезность ошибки.
DriverUnifiedPosHealthCheckLevel Это перечисление указывает тип проверки работоспособности, выполняемый при вызове CheckHealthAsync на устройстве POS.
DriverUnifiedPosPowerReportingType Это перечисление определяет тип отчетов о мощности, поддерживаемых устройством (например, advanced, standard и т. д.).
DriverUnifiedPosPowerState Это перечисление не реализовано.
MsrAuthenticationProtocolType Это перечисление определяет протоколы проверки подлинности с помощью магнитной полосы (MSR).
MsrCardType Это перечисление определяет типы карт магнитной полосы.
MsrDataEncryption Это перечисление определяет тип алгоритма шифрования, поддерживаемого средством чтения магнитной полосы (MSR).
MsrErrorReportingType Это перечисление определяет константы, указывающие тип отчетов об ошибках для средства чтения магнитной полосы (MSR).
MsrStatusUpdateType Это перечисление определяет константы, указывающие состояние средства чтения магнитной полосы (MSR).
MsrTrackErrorType Это перечисление определяет типы ошибок чтения магнитной полосы.
MsrTrackIds Определяет константы, представляющие треки чтения магнитной полосы (MSR).
MstStatisticsEntryType Это перечисление определяет типы статистики чтения магнитных полос.
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 определяет важность события и порядок его доставки клиентскому приложению.
POSCXFUNCENUM Предоставляет список всех функций API WDF PosCx.
PosDeviceControlType Это перечисление определяет значения для операций ввода-вывода драйвера сканера и драйвера магнитной полосы (MSR).
PosDeviceType Это перечисление определяет значения, используемые в структуре PosDeviceBasicsType, чтобы указать тип устройства (например, сканер штрихкодов или средство чтения магнитной полосы).
PosEventType Это перечисление определяет значения, используемые в структуре PosEventDataHeader, чтобы указать тип создаваемого события.
PosPropertyId Это перечисление определяет идентификаторы свойств для свойств, которые драйверы устройств должны обрабатываться для рассмотрения сканера штрихкодов или средства чтения с магнитной полосой (MSR).

Functions

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_INIT POS_CX_ATTRIBUTES_INIT инициализирует структуру POS_CX_ATTRIBUTES.
PosCxClaimDevice PosCxClaimDevice вызывается для утверждения устройства для эксклюзивного использования. Вызывающий объект должен вызывать PosCxReleaseDevice, если устройство больше не требуется.
PosCxCleanPendingRequests PosCxCleanPendingRequests вызывается для отмены всех ожидающих запросов для данного вызывающего объекта, определяемого открытым экземпляром.
PosCxCleanupEvents PosCxCleanupEvents вызывается для очистки всех ожидающих событий для данного вызывающего объекта, определяемого открытым экземпляром.
PosCxClose PosCxClose вызывается для удаления открытого экземпляра библиотеки PosCx. Эта функция освобождает устройство, если вызывающий является владельцем, и отменяет ожидающие запросы. Он должен вызываться из EVT_WDF_FILE_CLOSE обратного вызова драйвера.
PosCxGetDeviceInterfaceTag PosCxGetDeviceInterfaceTag возвращает тег интерфейса устройства, заданный в PosCxOpen.
PosCxGetPendingEvent PosCxGetPendingEvent вызывается из обратного вызова чтения устройства или при поступлении нового события.
PosCxInit PosCxInit вызывается для инициализации внутренних ресурсов библиотеки PosCx. Ресурсы привязаны к устройству и освобождаются при удалении устройства.
PosCxIsDeviceOwner PosCxIsDeviceOwner проверяет, владеет ли вызывающий объект утверждением на устройстве.
PosCxIsPosApp PosCxIsPosApp проверяет, связан ли открытый экземпляр с приложением точки обслуживания.
PosCxMarkPosApp PosCxMarkPosApp помечает открытый экземпляр как связанный или не связанный с приложением точки обслуживания.
PosCxOpen PosCxOpen вызывается для создания открытого экземпляра библиотеки PosCx. Эта функция инициализирует все ресурсы, необходимые для управления одним открытым экземпляром. Он должен вызываться из EVT_WDF_DEVICE_FILE_CREATE обратного вызова драйвера.
PosCxPutPendingEvent PosCxPutPendingEvent создает новый объект события, копирует данные события в новый объект события и пытается делегировать его вызывающему объекту ожидания.
PosCxPutPendingEventMemory PosCxPutPendingEventMemory пытается делегировать объект памяти, содержащий данные события вызывающему объекту ожидания.
PosCxReleaseDevice PosCxReleaseDevice вызывается для выпуска устройства, которое ранее утверждалось с PosCxClaimDevice. После выпуска устройства будет повышен следующий ожидающий запрос утверждений.
PosCxRemoteRequestRelease PosCxRemoteRequestRelease вызывается всякий раз, когда удаленное устройство запрашивает освобождение устройства. Это инициирует согласование утверждений.
PosCxRetainDevice PosCxRetainDevice вызывается для расширения владения устройством.

Структуры

BarcodeSymbologyAttributesData Структура BarcodeSymbologyAttributesData содержит сведения о атрибутах для символики штрихкода.
MSR_AUTHENTICATE_DEVICE Эта структура предоставляет сведения о проверке подлинности, используемые для проверки подлинности устройства.
MSR_DATA_RECEIVED Эта структура содержит данные, считыванные из карточки с магнитной полоской с пальцем.
MSR_DEAUTHENTICATE_DEVICE Эта структура предоставляет сведения, необходимые для отмены проверки подлинности устройства.
MSR_ERROR_EVENT Эта структура содержит данные об ошибках, передаваемые в событие MagneticStripeReaderErrorOccured.
MSR_RETRIEVE_DEVICE_AUTHENTICATION_DATA Эта структура содержит сведения о проверке подлинности, полученные с устройства.
MSR_SUPPORTED_CARD_TYPES Эта структура определяет типы карт магнитной полосы, поддерживаемые средством чтения.
MSR_UPDATE_KEY Эта структура содержит сведения, необходимые для задания нового ключа шифрования.
POS_CX_ATTRIBUTES Структура POS_CX_ATTRIBUTES содержит указатели на функции обратного вызова событий, реализованные драйвером клиента.
PosBarcodeScanDataTypeDataData Эта структура описывает буфер символов штрихкода, поддерживаемых драйвером.
PosBarcodeScannerCapabilitiesType Эта структура определяет тип возможностей сканера, поддерживаемых устройством, например, поддерживает ли устройство статистические отчеты и предварительный просмотр изображений.
PosBarcodeScannerDataReceivedEventData Эта структура содержит отсканированные данные, передаваемые в событие BarcodeScannerDataReceived.
PosBarcodeScannerErrorOccurredEventData Эта структура содержит данные об ошибках, передаваемые в событие BarcodeScannerErrorOccurred.
PosDeviceBasicsType Эта структура указывает тип устройства, версии и рекомендуемого размера буфера, указанного драйвером.
PosDeviceInformation Эта структура предоставляет сведения об устройстве в соответствии со стандартом Унифицированной точки обслуживания (UPOS).
PosEventDataHeader Эта структура описывает отсканированные данные изображения, передаваемые в событие BarcodeScannerImagePreviewReceived.
PosMagneticStripeReaderCapabilitiesType Эта структура определяет типы возможностей средства чтения магнитной полосы (MSR), поддерживаемые устройством, например, поддерживает ли устройство отслеживание маскирования данных.
PosProfileType Эта структура описывает количество строк профиля в буфере.
PosStatisticsHeader Эта структура определяет стандартную информацию об устройстве единой точки обслуживания (UPOS). Эта структура является заголовком для входящей статистики.
PosStatusUpdatedEventData Эта структура содержит данные, передаваемые событию StatusUpdated.
PosStringType Эта структура представляет строку юникода точки службы (POS) длиной DataLengthInBytes.
PosValueStatisticsEntry Эта структура содержит значение статистики.