IOCTL_GNSS_GET_FIXDATA IOCTL(gnssdriver.h)

아티클
02/06/2022
읽는 데 2분 걸림

IOCTL_GNSS_GET_FIXDATA 제어 코드는 GNSS 어댑터에서 활성 수정 세션에서 다음 수정 데이터를 수신하도록 등록하는 데 사용됩니다. 이 IOCTL은 GNSS 드라이버에 보류 중인 I/O 요청을 제공하며, 이 비동기 확인은 겹치는 구조체 GnssEvent 멤버를 통해 데이터가 데이터 버퍼로 제공되고 있음을 어댑터에 알릴 수 있습니다. GnssEvent 멤버는 GNSS_EVENT 구조체입니다.

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

수정 세션 ID를 나타내는 DWORD 값에 대한 포인터입니다.

입력 버퍼 길이

sizeof(DWORD)로 설정합니다.

출력 버퍼

NULL로 설정

출력 버퍼 길이

0으로 설정합니다.

상태 블록

요청이 성공하면 Irp->IoStatus.Status가 STATUS_SUCCESS 설정됩니다. 그렇지 않으면 NTSTATUS 코드로 적절한 오류 조건에 대한 상태입니다.

설명

입력

FixSessionID: 활성 수정에 대한 세션 ID입니다.

출력

GNSS_EVENT

EventType 요소는 GNSS_Event_FixAvailable 설정해야 합니다.

이 이벤트와 연결된 데이터는 GNSS_FIXDATA 형식입니다.

GNSS 어댑터 노트

GNSS 어댑터는 수정 세션을 시작한 후 하나 이상의 수정 요청 가져오기를 발급합니다. 이 호출은 기본 GNSS 엔진 또는 캐시 값에서 사용할 수 있는 경우 GNSS 드라이버가 수정 데이터를 반환할 수 있는 보류 중인 I/O를 만듭니다.

GNSS 드라이버 노트

수정 데이터가 준비되면 드라이버가 버퍼를 채우고 I/O를 완료합니다. 드라이버는 지정된 수정 세션 ID에 대한 데이터가 반환되는지 확인해야 합니다.

수정 데이터가 준비되면 드라이버는 버퍼를 채우고 I/O 요청을 완료해야 합니다. 지정된 수정 세션 ID에 대한 데이터가 반환되도록 하는 것은 드라이버의 책임입니다. 또한 IOCTL_GNSS_STOP_FIXSESSION 발급하는 GNSS 어댑터에 의해 수정 세션이 중지되면 드라이버는 지정된 수정 세션 ID에 대한 보류 중인 모든 수정 요청 가져오기를 취소해야 합니다.