Ponto de Serviço (POS)

Visão geral da tecnologia de driver de dispositivo de PDV (Ponto de Serviço).

Para desenvolver drivers de dispositivo pos (ponto de serviço), você precisa destes cabeçalhos:

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

Para obter o guia de programação, consulte POS (Ponto de Serviço).

IOCTLs

IOCTL_POINT_OF_SERVICE_CHECK_HEALTH Essa função de controle de E/S verifica a integridade do dispositivo.
IOCTL_POINT_OF_SERVICE_CLAIM_DEVICE A função de controle de E/S declara o dispositivo para acesso exclusivo.
IOCTL_POINT_OF_SERVICE_GET_DEVICE_BASICS Essa função de controle de E/S obtém o tipo de dispositivo, versão e tamanho de buffer recomendado, conforme especificado pelo driver.
IOCTL_POINT_OF_SERVICE_GET_PROPERTY Essa função de controle de E/S retorna o valor da propriedade especificada do driver de dispositivo.
IOCTL_POINT_OF_SERVICE_MSR_AUTHENTICATE_DEVICE Essa função de controle de E/S autentica o MSR (leitor de listras magnéticas).
IOCTL_POINT_OF_SERVICE_MSR_DEAUTHENTICATE_DEVICE Essa função de controle de E/S desautentica o leitor de tarja magnética (MSR).
IOCTL_POINT_OF_SERVICE_MSR_RETRIEVE_DEVICE_AUTHENTICATION Essa função de controle de E/S recupera o tipo de autenticação do dispositivo.
IOCTL_POINT_OF_SERVICE_MSR_UPDATE_KEY Essa função de controle de E/S define uma nova chave de criptografia.
IOCTL_POINT_OF_SERVICE_RELEASE_DEVICE Essa função de controle de E/S é chamada quando um cliente está pronto para abrir mão de sua declaração em um dispositivo.
IOCTL_POINT_OF_SERVICE_RESET_STATISTICS Essa função de controle de E/S redefine o valor da estatística especificada como zero.
IOCTL_POINT_OF_SERVICE_RETAIN_DEVICE Essa função de controle de E/S é usada para manter uma declaração em um dispositivo quando um cliente é notificado de que sua declaração no dispositivo está sendo contestada por outro cliente.
IOCTL_POINT_OF_SERVICE_RETRIEVE_STATISTICS Essa função de controle de E/S retorna informações padrão de UPOS (ponto de serviço unificado) sobre um dispositivo, como sua categoria, fabricante e número de revisão de firmware.
IOCTL_POINT_OF_SERVICE_SET_PROPERTY Essa função de controle de E/S define a propriedade especificada no dispositivo.
IOCTL_POINT_OF_SERVICE_UPDATE_STATISTICS Essa função de controle de E/S define a estatística especificada como o valor no buffer de entrada.

Enumerações

BarcodeStatus Essa enumeração indica valores de status do scanner de código de barras.
BarcodeSymbology Essa enumeração define as simbologias de código de barras.
BarcodeSymbologyDecodeLengthType A enumeração BarcodeSymbologyDecodeLengthType descreve valores para o comprimento de decodificação que podem ser definidos para dar suporte a um intervalo, dois valores discretos ou ser definidos com qualquer comprimento.
DriverMagneticStripeReaderAuthenticationLevel Essa enumeração define os níveis de suporte à autenticação msr (leitor de faixa magnética).
DriverUnifiedPosErrorReason Essa enumeração indica o motivo do erro.
DriverUnifiedPosErrorSeverity Essa enumeração indica a gravidade do erro.
DriverUnifiedPosHealthCheckLevel Essa enumeração indica o tipo de verificação de integridade a ser executada quando CheckHealthAsync é chamado em um dispositivo POS.
DriverUnifiedPosPowerReportingType Essa enumeração define o tipo de relatório de energia compatível com o dispositivo (por exemplo, avançado, padrão e assim por diante).
DriverUnifiedPosPowerState Essa enumeração não é implementada.
MsrAuthenticationProtocolType Essa enumeração define protocolos de autenticação msr (leitor de faixa magnética).
MsrCardType Essa enumeração define os tipos de cartões de tarja magnética.
MsrDataEncryption Essa enumeração define o tipo de algoritmo de criptografia compatível com o MSR (leitor de faixa magnética).
MsrErrorReportingType Essa enumeração define as constantes que indicam o tipo de relatório de erros para o leitor de tarja magnética (MSR).
MsrStatusUpdateType Essa enumeração define as constantes que indicam o status do leitor de tarja magnética (MSR).
MsrTrackErrorType Essa enumeração define os tipos de erros de rastreamento de leitor de faixa magnética.
MsrTrackIds Define as constantes que representam as faixas do leitor de listras magnéticas (MSR).
MstStatisticsEntryType Essa enumeração define os tipos de estatísticas de leitor de faixa magnética.
POS_CX_EVENT_ATTRIBUTES O POS_CX_EVENT_ATTRIBUTES descreve a prioridade e os direitos de acesso para os eventos de POS provenientes do dispositivo. Os valores são uma combinação dos valores definidos em POS_CX_EVENT_DEST e POS_CX_EVENT_PRIORITY.
POS_CX_EVENT_DEST O POS_CX_EVENT_DEST define quais aplicativos recebem esse evento.
POS_CX_EVENT_PRIORITY O POS_CX_EVENT_PRIORITY define a importância do evento e a ordem em que ele será entregue ao aplicativo cliente.
POSCXFUNCENUM Fornece uma lista de todas as funções da API do WDF poscx.
PosDeviceControlType Essa enumeração define valores para as IOCTLs do driver do scanner e do driver msr (leitor de listras magnéticas).
PosDeviceType Essa enumeração define valores usados na estrutura PosDeviceBasicsType para indicar o tipo de dispositivo (por exemplo, scanner de código de barras ou leitor de faixa magnética).
PosEventType Essa enumeração define valores usados na estrutura PosEventDataHeader para indicar o tipo de evento que foi gerado.
PosPropertyId Essa enumeração define os identificadores de propriedade para as propriedades que os drivers de dispositivo precisam manipular para serem consideradas um scanner de código de barras ou um MSR (leitor de faixa magnética).

Funções

EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE O retorno de chamada EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE é chamado durante a transição de propriedade da declaração de API. Espera-se que o driver defina o dispositivo de volta para um estado padrão nessa rotina.
EVT_POS_CX_DEVICE_REMOTE_CLAIM O retorno de chamada EVT_POS_CX_DEVICE_REMOTE_CLAIM é chamado quando o dispositivo está fazendo a transição de não solicitado para declarado e permite que o driver faça trabalho adicional.
EVT_POS_CX_DEVICE_REMOTE_RELEASE O retorno de chamada EVT_POS_CX_DEVICE_REMOTE_RELEASE é chamado sempre que o dispositivo é liberado e deixado sem proprietário e permite que o driver faça trabalho adicional.
EVT_POS_CX_DEVICE_REMOTE_RETAIN O retorno de chamada EVT_POS_CX_DEVICE_REMOTE_RETAIN é chamado sempre que PosCx tenta manter uma declaração em um dispositivo de rede e permite que o driver faça trabalho adicional.
POS_CX_ATTRIBUTES_INIT POS_CX_ATTRIBUTES_INIT inicializa uma estrutura de POS_CX_ATTRIBUTE.
PosCxClaimDevice PosCxClaimDevice é chamado para reivindicar um dispositivo para uso exclusivo. O chamador deve chamar PosCxReleaseDevice quando o dispositivo não for mais necessário.
PosCxCleanPendingRequests PosCxCleanPendingRequests é chamado para cancelar todas as solicitações pendentes para um determinado chamador, identificadas pela instância aberta.
PosCxCleanupEvents PosCxCleanupEvents é chamado para limpar todos os eventos pendentes para um determinado chamador, identificado pela instância aberta.
PosCxClose PosCxClose é chamado para excluir uma instância de biblioteca PosCx aberta. Essa função libera o dispositivo se o chamador for o proprietário e cancela as solicitações pendentes. Ele deve ser chamado do retorno de chamada EVT_WDF_FILE_CLOSE do driver.
PosCxGetDeviceInterfaceTag PosCxGetDeviceInterfaceTag retorna a marca de interface do dispositivo definida em PosCxOpen.
PosCxGetPendingEvent PosCxGetPendingEvent é chamado do retorno de chamada de leitura do dispositivo ou quando um novo evento chega.
PosCxInit PosCxInit é chamado para inicializar os recursos internos da biblioteca PosCx. Os recursos são vinculados ao dispositivo e são liberados quando o dispositivo desaparece.
PosCxIsDeviceOwner PosCxIsDeviceOwner verifica se o chamador possui atualmente a declaração no dispositivo.
PosCxIsPosApp PosCxIsPosApp verifica se a instância aberta está associada a um aplicativo de ponto de serviço.
PosCxMarkPosApp PosCxMarkPosApp marca a instância aberta como associada ou não a um aplicativo de ponto de serviço.
PosCxOpen PosCxOpen é chamado para criar uma instância de biblioteca PosCx aberta. Essa função inicializa todos os recursos necessários para gerenciar uma única instância aberta. Ele deve ser chamado do retorno de chamada EVT_WDF_DEVICE_FILE_CREATE do driver.
PosCxPutPendingEvent PosCxPutPendingEvent cria um novo objeto de evento, copia os dados do evento para o novo objeto de evento e tenta delegar para o chamador em espera.
PosCxPutPendingEventMemory PosCxPutPendingEventMemory tenta delegar um objeto de memória que contém os dados do evento a um chamador em espera.
PosCxReleaseDevice PosCxReleaseDevice é chamado para liberar um dispositivo que foi anteriormente reivindicado com PosCxClaimDevice. Depois que o dispositivo for liberado, o próximo solicitante de declaração pendente será promovido.
PosCxRemoteRequestRelease PosCxRemoteRequestRelease é chamado sempre que um dispositivo remoto solicita a liberação do dispositivo. Isso inicia a negociação de declarações.
PosCxRetainDevice PosCxRetainDevice é chamado para estender a propriedade do dispositivo.

Estruturas

BarcodeSymbologyAttributesData A estrutura BarcodeSymbologyAttributesData contém as informações de atributo de uma simbologia de código de barras.
MSR_AUTHENTICATE_DEVICE Essa estrutura fornece as informações de autenticação usadas para autenticar um dispositivo.
MSR_DATA_RECEIVED Essa estrutura contém os dados lidos de um cartão de distribuição magnética apagado.
MSR_DEAUTHENTICATE_DEVICE Essa estrutura fornece as informações necessárias para desautenticar o dispositivo.
MSR_ERROR_EVENT Essa estrutura contém os dados de erro que são passados para o evento MagneticStripeReaderErrorOccured.
MSR_RETRIEVE_DEVICE_AUTHENTICATION_DATA Essa estrutura contém informações de autenticação recuperadas do dispositivo.
MSR_SUPPORTED_CARD_TYPES Essa estrutura define os tipos de cartões de listras magnéticas compatíveis com o leitor.
MSR_UPDATE_KEY Essa estrutura contém as informações necessárias para definir uma nova chave de criptografia.
POS_CX_ATTRIBUTES A estrutura POS_CX_ATTRIBUTES contém ponteiros para funções de retorno de chamada de evento implementadas pelo driver cliente.
PosBarcodeScanDataTypeData Essa estrutura descreve um buffer de simbologias de código de barras com suporte do driver.
PosBarcodeScannerCapabilitiesType Essa estrutura define o tipo de recursos de scanner que um dispositivo dá suporte, como se o dispositivo dá suporte a relatórios de estatísticas e visualização de imagem.
PosBarcodeScannerDataReceivedEventData Essa estrutura contém os dados verificados que são passados para o evento BarcodeScannerDataReceived.
PosBarcodeScannerErrorOccurredEventData Essa estrutura contém os dados de erro que são passados para o evento BarcodeScannerErrorOccurred.
PosDeviceBasicsType Essa estrutura indica o tipo de dispositivo, versão e tamanho de buffer recomendado, conforme especificado pelo driver.
PosDeviceInformation Essa estrutura fornece informações do dispositivo conforme definido no e exigido pelo padrão UPOS (Ponto unificado de serviço).
PosEventDataHeader Essa estrutura descreve os dados de imagem digitalizados que são passados para o evento BarcodeScannerImagePreviewReceived.
PosMagneticStripeReaderCapabilitiesType Essa estrutura define os tipos de recursos msr (leitor de listras magnéticas) que um dispositivo dá suporte, como se o dispositivo dá suporte à máscara de dados de rastreamento.
PosProfileType Essa estrutura descreve o número de cadeias de caracteres de perfil em um buffer.
PosStatisticsHeader Essa estrutura define informações padrão do UPOS (Ponto unificado de serviço) sobre um dispositivo. Essa estrutura é o cabeçalho de uma estatística de entrada.
PosStatusUpdatedEventData Essa estrutura contém dados passados para o evento StatusUpdated.
PosStringType Essa estrutura representa uma cadeia de caracteres unicode de Ponto de Serviço (POS) com um comprimento de DataLengthInBytes.
PosValueStatisticsEntry Essa estrutura contém o valor de uma estatística.