poscx.h 헤더

아티클
11/08/2024

이 헤더는 pos에서 사용됩니다. 자세한 내용은 다음을 참조하세요.

POS(서비스 지점)

poscx.h에는 다음과 같은 프로그래밍 인터페이스가 포함되어 있습니다.

함수


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는 디바이스의 소유권을 확장하기 위해 호출됩니다.

콜백 함수


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 POS_CX_ATTRIBUTES 구조에는 클라이언트 드라이버에서 구현한 이벤트 콜백 함수에 대한 포인터가 포함됩니다.

열거형


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 이벤트의 중요성과 클라이언트 애플리케이션에 전달될 순서를 정의합니다.