POS (Point of Service)

Panoramica della tecnologia di driver di dispositivo POS (Point of Service).

Per sviluppare driver di dispositivo POS (Point of Service), sono necessarie queste intestazioni:

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

Per la guida alla programmazione, vedere Punto di servizio (POS).

IOCTL

IOCTL_POINT_OF_SERVICE_CHECK_HEALTH Questa funzione di controllo di I/O controlla l'integrità del dispositivo.
IOCTL_POINT_OF_SERVICE_CLAIM_DEVICE La funzione di controllo di I/O dichiara il dispositivo per l'accesso esclusivo.
IOCTL_POINT_OF_SERVICE_GET_DEVICE_BASICS Questa funzione di controllo di I/O ottiene il tipo di dispositivo, la versione e le dimensioni consigliate del buffer, come specificato dal driver.
IOCTL_POINT_OF_SERVICE_GET_PROPERTY Questa funzione di controllo di I/O restituisce il valore della proprietà specificata dal driver di dispositivo.
IOCTL_POINT_OF_SERVICE_MSR_AUTHENTICATE_DEVICE Questa funzione di controllo di I/O autentica il lettore di striping magnetico (MSR).
IOCTL_POINT_OF_SERVICE_MSR_DEAUTHENTICATE_DEVICE Questa funzione di controllo di I/O deautentica il lettore di striping magnetico (MSR).
IOCTL_POINT_OF_SERVICE_MSR_RETRIEVE_DEVICE_AUTHENTICATION Questa funzione di controllo di I/O recupera il tipo di autenticazione del dispositivo.
IOCTL_POINT_OF_SERVICE_MSR_UPDATE_KEY Questa funzione di controllo di I/O imposta una nuova chiave di crittografia.
IOCTL_POINT_OF_SERVICE_RELEASE_DEVICE Questa funzione di controllo di I/O viene chiamata quando un client è pronto a rinunciare all'attestazione in un dispositivo.
IOCTL_POINT_OF_SERVICE_RESET_STATISTICS Questa funzione di controllo di I/O reimposta il valore della statistica specificata su zero.
IOCTL_POINT_OF_SERVICE_RETAIN_DEVICE Questa funzione di controllo di I/O viene usata per mantenere un'attestazione in un dispositivo quando un client riceve una notifica che la richiesta sul dispositivo viene contestata da un altro client.
IOCTL_POINT_OF_SERVICE_RETRIEVE_STATISTICS Questa funzione di controllo di I/O restituisce informazioni standard upOS (Unified Point of Service) su un dispositivo, ad esempio la categoria, il produttore e il numero di revisione del firmware.
IOCTL_POINT_OF_SERVICE_SET_PROPERTY Questa funzione di controllo di I/O imposta la proprietà specificata nel dispositivo.
IOCTL_POINT_OF_SERVICE_UPDATE_STATISTICS Questa funzione di controllo di I/O imposta la statistica specificata sul valore nel buffer di input.

Enumerazioni

BarcodeStatus Questa enumerazione indica i valori di stato dello scanner di codice a barre.
Codice a barreSymbology Questa enumerazione definisce i simboli di codice a barre.
Codice a barreSymbologyDecodeLengthType L'enumerazione BarcodeSymbologyDecodeLengthType descrive i valori per la lunghezza della decodifica che può essere impostata per supportare un intervallo, due valori discreti o essere impostati su qualsiasi lunghezza.
DriverMagneticStripeReaderAuthenticationLevel Questa enumerazione definisce i livelli di supporto per l'autenticazione del lettore di striping magnetico (MSR).
DriverUnifiedPosErrorReason Questa enumerazione indica il motivo dell'errore.
DriverUnifiedPosErrorSeverity Questa enumerazione indica la gravità dell'errore.
DriverUnifiedPosHealthCheckLevel Questa enumerazione indica il tipo di controllo di integrità da eseguire quando si chiama CheckHealthAsync in un dispositivo POS.
DriverUnifiedPosPowerReportingType Questa enumerazione definisce il tipo di segnalazione alimentazione supportato dal dispositivo , ad esempio avanzato, standard e così via.
DriverUnifiedPosPowerState Questa enumerazione non è implementata.
MsrAuthenticationProtocolType Questa enumerazione definisce i protocolli di autenticazione del lettore di striping magnetico (MSR).
MsrCardType Questa enumerazione definisce i tipi di schede di banda magnetica.
MsrDataEncryption Questa enumerazione definisce il tipo di algoritmo di crittografia supportato dal lettore di striping magnetico (MSR).
MsrErrorReportingType Questa enumerazione definisce le costanti che indicano il tipo di segnalazione degli errori per il lettore di striping magnetico (MSR).
MsrStatusUpdateType Questa enumerazione definisce le costanti che indicano lo stato del lettore di striping magnetico (MSR).
MsrTrackErrorType Questa enumerazione definisce i tipi di errori di rilevamento delle strisce magnetiche.
MsrTrackIds Definisce le costanti che rappresentano le tracce del lettore di banda magnetica (MSR).
MstStatisticsEntryType Questa enumerazione definisce i tipi di statistiche del lettore di strisce magnetiche.
POS_CX_EVENT_ATTRIBUTES Il POS_CX_EVENT_ATTRIBUTES descrive la priorità e i diritti di accesso per gli eventi POS provenienti dal dispositivo. I valori sono una combinazione dei valori definiti in POS_CX_EVENT_DEST e POS_CX_EVENT_PRIORITY.
POS_CX_EVENT_DEST Il POS_CX_EVENT_DEST definisce le applicazioni che ricevono questo evento.
POS_CX_EVENT_PRIORITY Il POS_CX_EVENT_PRIORITY definisce l'importanza dell'evento e l'ordine in cui verrà recapitato all'applicazione client.
POSCXFUNCENUM Fornisce un elenco di tutte le funzioni API WDF PosCx.
PosDeviceControlType Questa enumerazione definisce i valori per i valori IOCTL del driver dello scanner e del driver MSR (Magnetic Stripe Reader).
PosDeviceType Questa enumerazione definisce i valori utilizzati nella struttura PosDeviceBasicsType per indicare il tipo di dispositivo (ad esempio, scanner di codice a barre o lettore di strisce magnetiche).
PosEventType Questa enumerazione definisce i valori utilizzati nella struttura PosEventDataHeader per indicare il tipo di evento generato.
PosPropertyId Questa enumerazione definisce gli identificatori di proprietà per le proprietà che i driver di dispositivo devono gestire per essere considerati uno scanner di codice a barre o un lettore di striping magnetico (MSR).

Funzioni

EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE Il callback EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE viene chiamato durante la transizione della proprietà dell'attestazione API. Il driver dovrebbe ripristinare lo stato predefinito del dispositivo in questa routine.
EVT_POS_CX_DEVICE_REMOTE_CLAIM Il callback EVT_POS_CX_DEVICE_REMOTE_CLAIM viene chiamato quando il dispositivo passa da non richiesto a richiesto e consente al driver di eseguire operazioni aggiuntive.
EVT_POS_CX_DEVICE_REMOTE_RELEASE Il callback EVT_POS_CX_DEVICE_REMOTE_RELEASE viene chiamato ogni volta che il dispositivo viene rilasciato e lasciato senza proprietario e consente al driver di eseguire operazioni aggiuntive.
EVT_POS_CX_DEVICE_REMOTE_RETAIN Il callback EVT_POS_CX_DEVICE_REMOTE_RETAIN viene chiamato ogni volta che PosCx tenta di mantenere un'attestazione in un dispositivo di rete e consente al driver di eseguire operazioni aggiuntive.
POS_CX_ATTRIBUTES_INIT POS_CX_ATTRIBUTES_INIT inizializza una struttura POS_CX_ATTRIBUTE.
PosCxClaimDevice PosCxClaimDevice viene chiamato per richiedere un dispositivo per l'uso esclusivo. Il chiamante deve chiamare PosCxReleaseDevice quando il dispositivo non è più necessario.
PosCxCleanPendingRequests PosCxCleanPendingRequests viene chiamato per annullare tutte le richieste in sospeso per un chiamante specifico, identificato dall'istanza aperta.
PosCxCleanupEvents PosCxCleanupEvents viene chiamato per pulire tutti gli eventi in sospeso per un determinato chiamante, identificato dall'istanza aperta.
PosCxClose PosCxClose viene chiamato per eliminare un'istanza di libreria PosCx aperta. Questa funzione rilascia il dispositivo se il chiamante è il proprietario e annulla le richieste in sospeso. Deve essere chiamato dal callback del driver EVT_WDF_FILE_CLOSE.
PosCxGetDeviceInterfaceTag PosCxGetDeviceInterfaceTag restituisce il tag dell'interfaccia del dispositivo impostato in PosCxOpen.
PosCxGetPendingEvent PosCxGetPendingEvent viene chiamato dal callback di lettura del dispositivo o quando arriva un nuovo evento.
PosCxInit PosCxInit viene chiamato per inizializzare le risorse interne della libreria PosCx. Le risorse sono associate al dispositivo e vengono rilasciate quando il dispositivo va via.
PosCxIsDeviceOwner PosCxIsDeviceOwner verifica se il chiamante possiede attualmente l'attestazione nel dispositivo.
PosCxIsPosApp PosCxIsPosApp controlla se l'istanza aperta è associata a un'applicazione point-of-service.
PosCxMarkPosApp PosCxMarkPosApp contrassegna l'istanza aperta come associata o meno a un'applicazione point-of-service.
PosCxOpen PosCxOpen viene chiamato per creare un'istanza di libreria PosCx aperta. Questa funzione inizializza tutte le risorse necessarie per gestire un'unica istanza aperta. Deve essere chiamato dal callback del driver EVT_WDF_DEVICE_FILE_CREATE.
PosCxPutPendingEvent PosCxPutPendingEvent crea un nuovo oggetto evento, copia i dati dell'evento nel nuovo oggetto evento e tenta di delegarlo al chiamante in attesa.
PosCxPutPendingEventMemory PosCxPutPendingEventMemory tenta di delegare un oggetto memoria contenente i dati dell'evento a un chiamante in attesa.
PosCxReleaseDevice PosCxReleaseDevice viene chiamato per rilasciare un dispositivo precedentemente richiesto con PosCxClaimDevice. Una volta rilasciato il dispositivo, viene promosso il richiedente attestazione in sospeso successivo.
PosCxRemoteRequestRelease PosCxRemoteRequestRelease viene chiamato ogni volta che un dispositivo remoto chiede il rilascio del dispositivo. In questo modo viene avviata la negoziazione delle attestazioni.
PosCxRetainDevice PosCxRetainDevice viene chiamato per estendere la proprietà del dispositivo.

Strutture

BarcodeSymbologyAttributesData La struttura BarcodeSymbologyAttributesData contiene le informazioni sull'attributo per un simbolo di codice a barre.
MSR_AUTHENTICATE_DEVICE Questa struttura fornisce le informazioni di autenticazione usate per autenticare un dispositivo.
MSR_DATA_RECEIVED Questa struttura contiene i dati letti da una scheda di striscia magnetica con scorrimento rapido.
MSR_DEAUTHENTICATE_DEVICE Questa struttura fornisce le informazioni necessarie per deutenticare il dispositivo.
MSR_ERROR_EVENT Questa struttura contiene i dati di errore passati all'evento MagneticStripeReaderErrorOccured.
MSR_RETRIEVE_DEVICE_AUTHENTICATION_DATA Questa struttura contiene informazioni di autenticazione recuperate dal dispositivo.
MSR_SUPPORTED_CARD_TYPES Questa struttura definisce i tipi di schede di striscia magnetica supportate dal lettore.
MSR_UPDATE_KEY Questa struttura contiene le informazioni necessarie per impostare una nuova chiave di crittografia.
POS_CX_ATTRIBUTES La struttura POS_CX_ATTRIBUTES contiene puntatori alle funzioni di callback degli eventi implementate dal driver client.
PosBarcodeScanDataTypeData Questa struttura descrive un buffer di simboli di codice a barre supportati dal driver.
PosBarcodeScannerCapabilitiesType Questa struttura definisce il tipo di funzionalità dello scanner supportate da un dispositivo, ad esempio se il dispositivo supporta la creazione di report delle statistiche e l'anteprima delle immagini.
PosBarcodeScannerDataReceivedEventData Questa struttura contiene i dati analizzati passati all'evento BarcodeScannerDataReceived.
PosBarcodeScannerErrorOccurredEventData Questa struttura contiene i dati di errore passati all'evento BarcodeScannerErrorOccurred.
PosDeviceBasicsType Questa struttura indica il tipo di dispositivo, versione e dimensioni del buffer consigliate, come specificato dal driver.
PosDeviceInformation Questa struttura fornisce informazioni sul dispositivo definite in e richieste dallo standard UPOS (Unified Point of Service).
PosEventDataHeader Questa struttura descrive i dati dell'immagine analizzata passati all'evento BarcodeScannerImagePreviewReceived.
PosMagneticStripeReaderCapabilitiesType Questa struttura definisce i tipi di funzionalità di lettore di banda magnetica (MSR) supportate da un dispositivo, ad esempio se il dispositivo supporta la maschera dati di traccia.
PosProfileType Questa struttura descrive il numero di stringhe del profilo in un buffer.
PosStatisticsHeader Questa struttura definisce le informazioni standard UPOS (Unified Point of Service) su un dispositivo. Questa struttura è l'intestazione per una statistica in ingresso.
PosStatusUpdatedEventData Questa struttura contiene i dati passati all'evento StatusUpdated.
PosStringType Questa struttura rappresenta una stringa unicode Point of Service (POS) con lunghezza di DataLengthInBytes.
PosValueStatisticsEntry Questa struttura contiene il valore di una statistica.