Intestazione poscx.h

Questa intestazione viene usata da pos. Per altre informazioni, vedere:

• pos (Point of Service)

poscx.h contiene le interfacce di programmazione seguenti:

Funzioni

POS_CX_ATTRIBUTES_INIT POS_CX_ATTRIBUTES_INIT inizializza una struttura POS_CX_ATTRIBUTE.
PosCxClaimDevice PosCxClaimDevice viene chiamato per richiedere un dispositivo per 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 determinato chiamante, 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 viene rimosso.
PosCxIsDeviceOwner PosCxIsDeviceOwner controlla se il chiamante è attualmente proprietario dell'attestazione nel dispositivo.
PosCxIsPosApp PosCxIsPosApp verifica se l'istanza aperta è associata a un'applicazione punto di servizio.
PosCxMarkPosApp PosCxMarkPosApp contrassegna l'istanza aperta come associata o non associata a un'applicazione punto di servizio.
PosCxOpen PosCxOpen viene chiamato per creare un'istanza di libreria PosCx aperta. Questa funzione inizializza tutte le risorse necessarie per gestire una singola 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. Dopo il rilascio del dispositivo, il richiedente di attestazioni in sospeso successivo viene alzato di livello.
PosCxRemoteRequestRelease PosCxRemoteRequestRelease viene chiamato ogni volta che un dispositivo remoto richiede il rilascio del dispositivo. Viene avviata la negoziazione delle attestazioni.
PosCxRetainDevice PosCxRetainDevice viene chiamato per estendere la proprietà del dispositivo.

Funzioni di callback

EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE Il callback EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE viene chiamato durante la transizione della proprietà dell'attestazione API. È previsto che il driver imposti di nuovo il dispositivo su uno stato predefinito 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 ulteriori operazioni.
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 ulteriori operazioni.

Strutture

POS_CX_ATTRIBUTES La struttura POS_CX_ATTRIBUTES contiene puntatori alle funzioni di callback degli eventi implementate dal driver client.

Enumerazioni

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.