Titik Layanan (POS)

Gambaran umum teknologi driver perangkat Point of Service (POS).

Untuk mengembangkan driver perangkat Point of Service (POS), Anda memerlukan header ini:

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

Untuk panduan pemrograman, lihat Titik Layanan (POS).

IOCTL

IOCTL_POINT_OF_SERVICE_CHECK_HEALTH Fungsi kontrol I/O ini memeriksa kesehatan perangkat.
IOCTL_POINT_OF_SERVICE_CLAIM_DEVICE Fungsi kontrol I/O mengklaim perangkat untuk akses eksklusif.
IOCTL_POINT_OF_SERVICE_GET_DEVICE_BASICS Fungsi kontrol I/O ini mendapatkan jenis perangkat, versi, dan ukuran buffer yang direkomendasikan seperti yang ditentukan oleh driver.
IOCTL_POINT_OF_SERVICE_GET_PROPERTY Fungsi kontrol I/O ini mengembalikan nilai properti yang ditentukan dari driver perangkat.
IOCTL_POINT_OF_SERVICE_MSR_AUTHENTICATE_DEVICE Fungsi kontrol IO ini mengautentikasi magnetic stripe reader (MSR).
IOCTL_POINT_OF_SERVICE_MSR_DEAUTHENTICATE_DEVICE Fungsi kontrol I/O ini membatalkan autentikasi pembaca strip magnetik (MSR).
IOCTL_POINT_OF_SERVICE_MSR_RETRIEVE_DEVICE_AUTHENTICATION Fungsi kontrol I/O ini mengambil jenis autentikasi perangkat.
IOCTL_POINT_OF_SERVICE_MSR_UPDATE_KEY Fungsi kontrol I/O ini menetapkan kunci enkripsi baru.
IOCTL_POINT_OF_SERVICE_RELEASE_DEVICE Fungsi kontrol I/O ini dipanggil ketika klien siap untuk melepaskan klaimnya pada perangkat.
IOCTL_POINT_OF_SERVICE_RESET_STATISTICS Fungsi kontrol I/O ini mengatur ulang nilai statistik yang ditentukan menjadi nol.
IOCTL_POINT_OF_SERVICE_RETAIN_DEVICE Fungsi kontrol I/O ini digunakan untuk menyimpan klaim pada perangkat ketika klien diberi tahu bahwa klaimnya pada perangkat sedang diperebutkan oleh klien lain.
IOCTL_POINT_OF_SERVICE_RETRIEVE_STATISTICS Fungsi kontrol I/O ini mengembalikan informasi standar unified point of service (UPOS) tentang perangkat seperti kategori, produsen, dan nomor revisi firmwarenya.
IOCTL_POINT_OF_SERVICE_SET_PROPERTY Fungsi kontrol I/O ini mengatur properti yang ditentukan pada perangkat.
IOCTL_POINT_OF_SERVICE_UPDATE_STATISTICS Fungsi kontrol I/O ini menetapkan statistik yang ditentukan ke nilai dalam buffer input.

Enumerasi

BarcodeStatus Enumerasi ini menunjukkan nilai status pemindai kode batang.
BarcodeSymbology Enumerasi ini mendefinisikan simbologi kode batang.
BarcodeSymbologyDecodeLengthType Enum BarcodeSymbologyDecodeLengthType menjelaskan nilai untuk panjang dekode yang dapat diatur untuk mendukung rentang, dua nilai diskrit, atau diatur ke panjang berapa pun.
DriverMagneticStripeReaderAuthenticationLevel Enumerasi ini mendefinisikan tingkat dukungan autentikasi magnetic stripe reader (MSR).
DriverUnifiedPosErrorReason Enumerasi ini menunjukkan alasan kesalahan.
DriverUnifiedPosErrorSeverity Enumerasi ini menunjukkan tingkat keparahan kesalahan.
DriverUnifiedPosHealthCheckLevel Enumerasi ini menunjukkan jenis pemeriksaan kesehatan yang akan dilakukan ketika CheckHealthAsync dipanggil pada perangkat POS.
DriverUnifiedPosPowerReportingType Enumerasi ini mendefinisikan jenis pelaporan daya yang didukung oleh perangkat (misalnya, tingkat lanjut, standar, dan sebagainya).
DriverUnifiedPosPowerState Enumerasi ini tidak diimplementasikan.
MsrAuthenticationProtocolType Enumerasi ini mendefinisikan protokol autentikasi magnetic stripe reader (MSR).
MsrCardType Enumerasi ini mendefinisikan jenis kartu stripe magnetik.
MsrDataEncryption Enumerasi ini mendefinisikan jenis algoritma enkripsi yang didukung oleh pembaca strip magnetik (MSR).
MsrErrorReportingType Enumerasi ini mendefinisikan konstanta yang menunjukkan jenis pelaporan kesalahan untuk pembaca strip magnetik (MSR).
MsrStatusUpdateType Enumerasi ini mendefinisikan konstanta yang menunjukkan status magnetic stripe reader (MSR).
MsrTrackErrorType Enumerasi ini mendefinisikan jenis kesalahan trek pembaca strip magnetik.
MsrTrackIds Mendefinisikan konstanta yang mewakili trek magnetic stripe reader (MSR).
MstStatisticsEntryType Enumerasi ini mendefinisikan jenis statistik pembaca strip magnetik.
POS_CX_EVENT_ATTRIBUTES POS_CX_EVENT_ATTRIBUTES menjelaskan prioritas dan hak akses untuk peristiwa POS yang berasal dari perangkat. Nilai adalah kombinasi dari nilai yang ditentukan dalam POS_CX_EVENT_DEST dan POS_CX_EVENT_PRIORITY.
POS_CX_EVENT_DEST POS_CX_EVENT_DEST menentukan aplikasi mana yang menerima peristiwa ini.
POS_CX_EVENT_PRIORITY POS_CX_EVENT_PRIORITY menentukan pentingnya peristiwa dan urutan yang akan dikirimkan ke aplikasi klien.
POSCXFUNCENUM Menyediakan daftar semua fungsi POSCx WDF API.
PosDeviceControlType Enumerasi ini mendefinisikan nilai untuk IOCTL driver pemindai dan driver magnetic stripe reader (MSR).
PosDeviceType Enumerasi ini mendefinisikan nilai yang digunakan dalam struktur PosDeviceBasicsType untuk menunjukkan jenis perangkat (misalnya, pemindai kode batang atau pembaca strip magnetik).
PosEventType Enumerasi ini mendefinisikan nilai yang digunakan dalam struktur PosEventDataHeader untuk menunjukkan jenis peristiwa yang dinaikkan.
PosPropertyId Enumerasi ini mendefinisikan pengidentifikasi properti untuk properti yang perlu ditangani driver perangkat untuk dianggap sebagai pemindai kode batang atau pembaca strip magnetik (MSR).

Fungsi

EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE Panggilan balik EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE dipanggil selama transisi kepemilikan klaim API. Driver diharapkan untuk mengatur perangkat kembali ke status default dalam rutinitas ini.
EVT_POS_CX_DEVICE_REMOTE_CLAIM Panggilan balik EVT_POS_CX_DEVICE_REMOTE_CLAIM dipanggil ketika perangkat beralih dari tidak diklaim ke diklaim dan memungkinkan driver untuk melakukan pekerjaan tambahan.
EVT_POS_CX_DEVICE_REMOTE_RELEASE Panggilan balik EVT_POS_CX_DEVICE_REMOTE_RELEASE dipanggil setiap kali perangkat dirilis dan ditinggalkan tanpa pemilik dan memungkinkan driver untuk melakukan pekerjaan tambahan.
EVT_POS_CX_DEVICE_REMOTE_RETAIN Panggilan balik EVT_POS_CX_DEVICE_REMOTE_RETAIN dipanggil setiap kali PosCx mencoba untuk memegang klaim pada perangkat jaringan dan memungkinkan driver untuk melakukan pekerjaan tambahan.
POS_CX_ATTRIBUTES_INIT POS_CX_ATTRIBUTES_INIT menginisialisasi struktur POS_CX_ATTRIBUTE.
PosCxClaimDevice PosCxClaimDevice dipanggil untuk mengklaim perangkat untuk penggunaan eksklusif. Pemanggil harus memanggil PosCxReleaseDevice ketika perangkat tidak lagi diperlukan.
PosCxCleanPendingRequests PosCxCleanPendingRequests dipanggil untuk membatalkan semua permintaan yang tertunda untuk pemanggil tertentu, yang diidentifikasi oleh instans terbuka.
PosCxCleanupEvents PosCxCleanupEvents dipanggil untuk membersihkan semua peristiwa yang tertunda untuk pemanggil tertentu, yang diidentifikasi oleh instans terbuka.
PosCxClose PosCxClose dipanggil untuk menghapus instans pustaka PosCx yang dibuka. Fungsi ini merilis perangkat jika pemanggil adalah pemiliknya, dan membatalkan permintaan yang tertunda. Ini harus dipanggil dari panggilan balik EVT_WDF_FILE_CLOSE driver.
PosCxGetDeviceInterfaceTag PosCxGetDeviceInterfaceTag mengembalikan tag antarmuka perangkat yang diatur di PosCxOpen.
PosCxGetPendingEvent PosCxGetPendingEvent dipanggil baik dari panggilan balik baca perangkat, atau ketika peristiwa baru tiba.
PosCxInit PosCxInit dipanggil untuk menginisialisasi sumber daya internal pustaka PosCx. Sumber daya terkait dengan perangkat, dan dirilis saat perangkat hilang.
PosCxIsDeviceOwner PosCxIsDeviceOwner memeriksa apakah penelepon saat ini memiliki klaim pada perangkat.
PosCxIsPosApp PosCxIsPosApp memeriksa apakah instans terbuka dikaitkan dengan aplikasi titik layanan.
PosCxMarkPosApp PosCxMarkPosApp menandai instans terbuka sebagai terkait atau tidak terkait dengan aplikasi titik layanan.
PosCxBuka PosCxOpen dipanggil untuk membuat instans pustaka PosCx terbuka. Fungsi ini menginisialisasi semua sumber daya yang diperlukan untuk mengelola satu instans terbuka. Ini harus dipanggil dari panggilan balik EVT_WDF_DEVICE_FILE_CREATE driver.
PosCxPutPendingEvent PosCxPutPendingEvent membuat objek peristiwa baru, menyalin data peristiwa ke objek peristiwa baru, dan mencoba mendelegasikannya ke pemanggil tunggu.
PosCxPutPendingEventMemory PosCxPutPendingEventMemory mencoba mendelegasikan objek memori yang berisi data peristiwa ke pemanggil tunggu.
PosCxReleaseDevice PosCxReleaseDevice dipanggil untuk merilis perangkat yang sebelumnya diklaim dengan PosCxClaimDevice. Setelah perangkat dirilis, pemohon klaim tertunda berikutnya akan dipromosikan.
PosCxRemoteRequestRelease PosCxRemoteRequestRelease dipanggil setiap kali perangkat jarak jauh meminta perangkat untuk dirilis. Ini memulai negosiasi klaim.
PosCxRetainDevice PosCxRetainDevice dipanggil untuk memperpanjang kepemilikan perangkat.

Struktur

BarcodeSymbologyAttributesData Struktur BarcodeSymbologyAttributesData berisi informasi atribut untuk simbologi kode batang.
MSR_AUTHENTICATE_DEVICE Struktur ini menyediakan informasi autentikasi yang digunakan untuk mengautentikasi perangkat.
MSR_DATA_RECEIVED Struktur ini berisi data yang dibaca dari kartu stripe magnetik yang di gesek.
MSR_DEAUTHENTICATE_DEVICE Struktur ini menyediakan informasi yang diperlukan untuk mendeauthenticate perangkat.
MSR_ERROR_EVENT Struktur ini berisi data kesalahan yang diteruskan ke peristiwa MagneticStripeReaderErrorOccured.
MSR_RETRIEVE_DEVICE_AUTHENTICATION_DATA Struktur ini berisi informasi autentikasi yang diambil dari perangkat.
MSR_SUPPORTED_CARD_TYPES Struktur ini mendefinisikan jenis kartu stripe magnetik yang didukung oleh pembaca.
MSR_UPDATE_KEY Struktur ini berisi informasi yang diperlukan untuk mengatur kunci enkripsi baru.
POS_CX_ATTRIBUTES Struktur POS_CX_ATTRIBUTES berisi pointer ke fungsi panggilan balik peristiwa yang diterapkan oleh driver klien.
PosBarcodeScanDataTypeData Struktur ini menjelaskan buffer simbologi barcode yang didukung oleh driver.
PosBarcodeScannerCapabilitiesType Struktur ini mendefinisikan jenis kemampuan pemindai yang didukung perangkat seperti apakah perangkat mendukung pelaporan statistik dan pratinjau gambar.
PosBarcodeScannerDataReceivedEventData Struktur ini berisi data yang dipindai yang diteruskan ke peristiwa BarcodeScannerDataReceived.
PosBarcodeScannerErrorOccurredEventData Struktur ini berisi data kesalahan yang diteruskan ke peristiwa BarcodeScannerErrorOccurred.
PosDeviceBasicsType Struktur ini menunjukkan jenis perangkat, versi, dan ukuran buffer yang direkomendasikan seperti yang ditentukan oleh driver.
PosDeviceInformation Struktur ini menyediakan informasi perangkat sebagaimana didefinisikan dalam dan yang diperlukan oleh standar Unified Point of Service (UPOS).
PosEventDataHeader Struktur ini menjelaskan data gambar yang dipindai yang diteruskan ke peristiwa BarcodeScannerImagePreviewReceived.
PosMagneticStripeReaderCapabilitiesType Struktur ini mendefinisikan jenis kemampuan magnetic stripe reader (MSR) yang didukung perangkat, seperti apakah perangkat mendukung pelacakan masking data.
PosProfileType Struktur ini menjelaskan jumlah string profil dalam buffer.
PosStatisticsHeader Struktur ini mendefinisikan informasi standar Unified Point of Service (UPOS) tentang perangkat. Struktur ini adalah header untuk statistik masuk.
PosStatusUpdatedEventData Struktur ini berisi data yang diteruskan ke peristiwa StatusUpdated.
PosStringType Struktur ini mewakili string unicode Point of Service (POS) dengan panjang DataLengthInBytes.
PosValueStatisticsEntry Struktur ini berisi nilai statistik.