header poscx.h

Header ini digunakan oleh pos. Untuk informasi selengkapnya, lihat:

• Titik Layanan (POS)

poscx.h berisi antarmuka pemrograman berikut:

Fungsi

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.

Fungsi panggilan balik

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.

Struktur

POS_CX_ATTRIBUTES Struktur POS_CX_ATTRIBUTES berisi pointer ke fungsi panggilan balik peristiwa yang diterapkan oleh driver klien.

Enumerasi

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.