POS(Point of Service)

POS(서비스 지점) 디바이스 드라이버 기술에 대한 개요입니다.

POS(서비스 지점) 디바이스 드라이버를 개발하려면 다음 헤더가 필요합니다.

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

프로그래밍 가이드는 POS(서비스 지점)를 참조하세요.

IOCTLs

IOCTL_POINT_OF_SERVICE_CHECK_HEALTH 이 I/O 컨트롤 함수는 디바이스 상태를 확인합니다.
IOCTL_POINT_OF_SERVICE_CLAIM_DEVICE I/O 컨트롤 함수는 단독 액세스를 위해 디바이스를 클레임합니다.
IOCTL_POINT_OF_SERVICE_GET_DEVICE_BASICS 이 I/O 컨트롤 함수는 드라이버에서 지정한 대로 디바이스, 버전 및 권장 버퍼 크기의 유형을 가져옵니다.
IOCTL_POINT_OF_SERVICE_GET_PROPERTY 이 I/O 컨트롤 함수는 디바이스 드라이버에서 지정된 속성의 값을 반환합니다.
IOCTL_POINT_OF_SERVICE_MSR_AUTHENTICATE_DEVICE 이 IO 컨트롤 함수는 MSR(자기 스트라이프 판독기)을 인증합니다.
IOCTL_POINT_OF_SERVICE_MSR_DEAUTHENTICATE_DEVICE 이 I/O 컨트롤 함수는 MSR(자기 줄무늬 판독기)을 해제합니다.
IOCTL_POINT_OF_SERVICE_MSR_RETRIEVE_DEVICE_AUTHENTICATION 이 I/O 컨트롤 함수는 디바이스 인증 유형을 검색합니다.
IOCTL_POINT_OF_SERVICE_MSR_UPDATE_KEY 이 I/O 컨트롤 함수는 새 암호화 키를 설정합니다.
IOCTL_POINT_OF_SERVICE_RELEASE_DEVICE 이 I/O 컨트롤 함수는 클라이언트가 디바이스에서 클레임을 포기할 준비가 되면 호출됩니다.
IOCTL_POINT_OF_SERVICE_RESET_STATISTICS 이 I/O 컨트롤 함수는 지정된 통계의 값을 0으로 다시 설정합니다.
IOCTL_POINT_OF_SERVICE_RETAIN_DEVICE 이 I/O 제어 함수는 클라이언트가 디바이스의 클레임이 다른 클라이언트에 의해 경합되고 있다는 알림을 받을 때 디바이스에서 클레임을 유지하는 데 사용됩니다.
IOCTL_POINT_OF_SERVICE_RETRIEVE_STATISTICS 이 I/O 제어 함수는 범주, 제조업체 및 펌웨어 수정 번호와 같은 디바이스에 대한 UPOS(통합 서비스 지점) 표준 정보를 반환합니다.
IOCTL_POINT_OF_SERVICE_SET_PROPERTY 이 I/O 컨트롤 함수는 디바이스에서 지정된 속성을 설정합니다.
IOCTL_POINT_OF_SERVICE_UPDATE_STATISTICS 이 I/O 컨트롤 함수는 지정된 통계를 입력 버퍼의 값으로 설정합니다.

열거형

BarcodeStatus 이 열거형은 바코드 스캐너 상태 값을 나타냅니다.
BarcodeSymbology 이 열거형은 바코드 기호를 정의합니다.
BarcodeSymbologyDecodeLengthType BarcodeSymbologyDecodeLengthType 열거형은 범위, 두 개의 불연속 값을 지원하도록 설정하거나 모든 길이로 설정할 수 있는 디코딩 길이의 값을 설명합니다.
DriverMagneticStripeReaderAuthenticationLevel 이 열거형은 MSR(자기 스트라이프 판독기) 인증 지원 수준을 정의합니다.
DriverUnifiedPosErrorReason 이 열거형은 오류의 이유를 나타냅니다.
DriverUnifiedPosErrorSeverity 이 열거형은 오류의 심각도를 나타냅니다.
DriverUnifiedPosHealthCheckLevel 이 열거형은 POS 디바이스에서 CheckHealthAsync가 호출될 때 수행할 상태 검사 유형을 나타냅니다.
DriverUnifiedPosPowerReportingType 이 열거형은 디바이스에서 지원하는 전원 보고 유형(예: 고급, 표준 등)을 정의합니다.
DriverUnifiedPosPowerState 이 열거형은 구현되지 않습니다.
MsrAuthenticationProtocolType 이 열거형은 MSR(자기 스트라이프 판독기) 인증 프로토콜을 정의합니다.
MsrCardType 이 열거형은 자기 줄무늬 카드의 종류를 정의합니다.
MsrDataEncryption 이 열거형은 MSR(자기 줄무늬 판독기)에서 지원하는 암호화 알고리즘의 종류를 정의합니다.
MsrErrorReportingType 이 열거형은 MSR(자기 스트라이프 판독기)의 오류 보고 유형을 나타내는 상수를 정의합니다.
MsrStatusUpdateType 이 열거형은 MSR(자기 스트라이프 판독기) 상태를 나타내는 상수를 정의합니다.
MsrTrackErrorType 이 열거형은 자기 줄무늬 판독기 트랙 오류의 종류를 정의합니다.
MsrTrackIds MSR(자기 줄무늬 판독기) 트랙을 나타내는 상수를 정의합니다.
MstStatisticsEntryType 이 열거형은 자기 줄무늬 판독기 통계의 종류를 정의합니다.
POS_CX_EVENT_ATTRIBUTES POS_CX_EVENT_ATTRIBUTES 디바이스에서 들어오는 POS 이벤트에 대한 우선 순위 및 액세스 권한을 설명합니다. 값은 POS_CX_EVENT_DEST 및 POS_CX_EVENT_PRIORITY 정의된 값의 조합입니다.
POS_CX_EVENT_DEST POS_CX_EVENT_DEST 이 이벤트를 수신하는 애플리케이션을 정의합니다.
POS_CX_EVENT_PRIORITY POS_CX_EVENT_PRIORITY 이벤트의 중요성과 클라이언트 애플리케이션에 전달될 순서를 정의합니다.
POSCXFUNCENUM 모든 PosCx WDF API 함수 목록을 제공합니다.
PosDeviceControlType 이 열거형은 스캐너 드라이버 및 MSR(자기 스트라이프 판독기) 드라이버의 IOCTL에 대한 값을 정의합니다.
PosDeviceType 이 열거형은 PosDeviceBasicsType 구조에서 디바이스 유형(예: 바코드 스캐너 또는 자기 스트라이프 판독기)을 나타내는 데 사용되는 값을 정의합니다.
PosEventType 이 열거형은 발생된 이벤트의 형식을 나타내기 위해 PosEventDataHeader 구조에 사용된 값을 정의합니다.
PosPropertyId 이 열거형은 디바이스 드라이버가 바코드 스캐너 또는 MSR(자기 스트립 판독기)으로 간주하기 위해 처리해야 하는 속성의 속성 식별자를 정의합니다.

Functions

EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE EVT_POS_CX_DEVICE_OWNERSHIP_CHANGE 콜백은 API 클레임 소유권 전환 중에 호출됩니다. 드라이버는 이 루틴에서 디바이스를 기본 상태로 다시 설정해야 합니다.
EVT_POS_CX_DEVICE_REMOTE_CLAIM EVT_POS_CX_DEVICE_REMOTE_CLAIM 콜백은 디바이스가 클레임되지 않은 에서 클레임됨으로 전환되고 드라이버가 추가 작업을 수행할 수 있도록 할 때 호출됩니다.
EVT_POS_CX_DEVICE_REMOTE_RELEASE EVT_POS_CX_DEVICE_REMOTE_RELEASE 콜백은 디바이스가 해제되고 소유자 없이 남아 있을 때마다 호출되며 드라이버에서 추가 작업을 수행할 수 있습니다.
EVT_POS_CX_DEVICE_REMOTE_RETAIN EVT_POS_CX_DEVICE_REMOTE_RETAIN 콜백은 PosCx가 네트워크 디바이스에서 클레임을 보류하려고 시도하고 드라이버가 추가 작업을 수행할 수 있도록 할 때마다 호출됩니다.
POS_CX_ATTRIBUTES_INIT POS_CX_ATTRIBUTES_INIT POS_CX_ATTRIBUTE 구조를 초기화합니다.
PosCxClaimDevice PosCxClaimDevice는 전용 사용을 위해 디바이스를 클레임하기 위해 호출됩니다. 호출자는 디바이스가 더 이상 필요하지 않은 경우 PosCxReleaseDevice를 호출해야 합니다.
PosCxCleanPendingRequests PosCxCleanPendingRequests는 열린 인스턴스로 식별된 지정된 호출자에 대한 보류 중인 모든 요청을 취소하기 위해 호출됩니다.
PosCxCleanupEvents PosCxCleanupEvents는 열린 인스턴스로 식별된 지정된 호출자에 대해 보류 중인 모든 이벤트를 정리하기 위해 호출됩니다.
PosCxClose 열린 PosCx 라이브러리 인스턴스를 삭제하기 위해 PosCxClose가 호출됩니다. 이 함수는 호출자가 소유자인 경우 디바이스를 해제하고 보류 중인 요청을 취소합니다. 드라이버의 EVT_WDF_FILE_CLOSE 콜백에서 호출해야 합니다.
PosCxGetDeviceInterfaceTag PosCxGetDeviceInterfaceTag는 PosCxOpen에 설정된 디바이스 인터페이스 태그를 반환합니다.
PosCxGetPendingEvent PosCxGetPendingEvent는 디바이스 읽기 콜백에서 또는 새 이벤트가 도착하면 호출됩니다.
PosCxInit PosCxInit는 PosCx 라이브러리의 내부 리소스를 초기화하기 위해 호출됩니다. 리소스는 디바이스에 연결되며 디바이스가 사라지면 해제됩니다.
PosCxIsDeviceOwner PosCxIsDeviceOwner는 호출자가 현재 디바이스에서 클레임을 소유하고 있는지 확인합니다.
PosCxIsPosApp PosCxIsPosApp은 열린 인스턴스가 서비스 지점 애플리케이션과 연결되어 있는지 확인합니다.
PosCxMarkPosApp PosCxMarkPosApp은 열린 인스턴스를 서비스 지점 애플리케이션과 연결되었거나 연결되지 않은 것으로 표시합니다.
PosCxOpen 열린 PosCx 라이브러리 인스턴스를 만들기 위해 PosCxOpen이 호출됩니다. 이 함수는 단일 열린 인스턴스를 관리하는 데 필요한 모든 리소스를 초기화합니다. 드라이버의 EVT_WDF_DEVICE_FILE_CREATE 콜백에서 호출해야 합니다.
PosCxPutPendingEvent PosCxPutPendingEvent는 새 이벤트 개체를 만들고, 이벤트 데이터를 새 이벤트 개체에 복사하고, 대기 중인 호출자에게 위임하려고 시도합니다.
PosCxPutPendingEventMemory PosCxPutPendingEventMemory는 이벤트 데이터가 포함된 메모리 개체를 대기 중인 호출자에게 위임하려고 합니다.
PosCxReleaseDevice PosCxReleaseDevice는 이전에 PosCxClaimDevice로 클레임된 디바이스를 해제하기 위해 호출됩니다. 디바이스가 해제되면 보류 중인 다음 클레임 요청자가 승격됩니다.
PosCxRemoteRequestRelease 원격 디바이스에서 디바이스를 해제하도록 요청할 때마다 PosCxRemoteRequestRelease가 호출됩니다. 그러면 클레임 협상이 시작됩니다.
PosCxRetainDevice PosCxRetainDevice는 디바이스의 소유권을 확장하기 위해 호출됩니다.

구조체

BarcodeSymbologyAttributesData BarcodeSymbologyAttributesData 구조에는 바코드 기호에 대한 특성 정보가 포함되어 있습니다.
MSR_AUTHENTICATE_DEVICE 이 구조는 디바이스를 인증하는 데 사용되는 인증 정보를 제공합니다.
MSR_DATA_RECEIVED 이 구조체에는 살짝 밀고 있는 자기 줄무늬 카드에서 읽은 데이터가 포함됩니다.
MSR_DEAUTHENTICATE_DEVICE 이 구조체는 디바이스를 인증하는 데 필요한 정보를 제공합니다.
MSR_ERROR_EVENT 이 구조체에는 MagneticStripeReaderErrorOccured 이벤트에 전달되는 오류 데이터가 포함됩니다.
MSR_RETRIEVE_DEVICE_AUTHENTICATION_DATA 이 구조에는 디바이스에서 검색된 인증 정보가 포함됩니다.
MSR_SUPPORTED_CARD_TYPES 이 구조체는 판독기에서 지원하는 자기 줄무늬 카드의 유형을 정의합니다.
MSR_UPDATE_KEY 이 구조에는 새 암호화 키를 설정하는 데 필요한 정보가 포함되어 있습니다.
POS_CX_ATTRIBUTES POS_CX_ATTRIBUTES 구조에는 클라이언트 드라이버에서 구현한 이벤트 콜백 함수에 대한 포인터가 포함되어 있습니다.
PosBarcodeScanDataTypeData 이 구조체는 드라이버에서 지원하는 바코드 기호의 버퍼를 설명합니다.
PosBarcodeScannerCapabilitiesType 이 구조는 디바이스가 통계 보고 및 이미지 미리 보기를 지원하는지 여부와 같이 디바이스에서 지원하는 스캐너 기능 유형을 정의합니다.
PosBarcodeScannerDataReceivedEventData 이 구조체에는 BarcodeScannerDataReceived 이벤트에 전달되는 스캔된 데이터가 포함됩니다.
PosBarcodeScannerErrorOccurredEventData 이 구조체에는 BarcodeScannerErrorOccurred 이벤트에 전달되는 오류 데이터가 포함됩니다.
PosDeviceBasicsType 이 구조체는 드라이버에서 지정한 디바이스, 버전 및 권장 버퍼 크기의 유형을 나타냅니다.
PosDeviceInformation 이 구조는 UPOS(Unified Point of Service) 표준에 정의되고 필요한 디바이스 정보를 제공합니다.
PosEventDataHeader 이 구조체는 BarcodeScannerImagePreviewReceived 이벤트에 전달되는 스캔된 이미지 데이터를 설명합니다.
PosMagneticStripeReaderCapabilitiesType 이 구조는 디바이스에서 데이터 마스킹 추적을 지원하는지 여부와 같이 디바이스에서 지원하는 MSR(자기 스트라이프 판독기) 기능의 종류를 정의합니다.
PosProfileType 이 구조체는 버퍼의 프로필 문자열 수를 설명합니다.
PosStatisticsHeader 이 구조는 디바이스에 대한 UPOS(Unified Point of Service) 표준 정보를 정의합니다. 이 구조체는 들어오는 통계의 헤더입니다.
PosStatusUpdatedEventData 이 구조체에는 StatusUpdated 이벤트에 전달된 데이터가 포함됩니다.
PosStringType 이 구조체는 DataLengthInBytes 길이의 POS(서비스 지점) 유니코드 문자열을 나타냅니다.
PosValueStatisticsEntry 이 구조체에는 통계의 값이 포함됩니다.