Skip to content

Latest commit

 

History

History
108 lines (72 loc) · 3.81 KB

ni-gnssdriver-ioctl_gnss_execute_cwtest.md

File metadata and controls

108 lines (72 loc) · 3.81 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NI:gnssdriver.IOCTL_GNSS_EXECUTE_CWTEST
IOCTL_GNSS_EXECUTE_CWTEST (gnssdriver.h)
The IOCTL_GNSS_EXECUTE_CWTEST control code is used by the GNSS manufacturing test application to start a carrier wave test and get the measurement. The test application must wait for the result before starting another iteration of the measurement.
gnss\ioctl_gnss_execute_cwtest.htm
gnss
02/15/2018
IOCTL_GNSS_EXECUTE_CWTEST IOCTL
IOCTL_GNSS_EXECUTE_CWTEST, IOCTL_GNSS_EXECUTE_CWTEST control, IOCTL_GNSS_EXECUTE_CWTEST control code [Sensor Devices], gnss.ioctl_gnss_execute_cwtest, gnssdriver/IOCTL_GNSS_EXECUTE_CWTEST
gnssdriver.h
Windows
Windows
IOCTL_GNSS_EXECUTE_CWTEST
gnssdriver/IOCTL_GNSS_EXECUTE_CWTEST
APIRef
kbSyntax
HeaderDef
gnssdriver.h
IOCTL_GNSS_EXECUTE_CWTEST

IOCTL_GNSS_EXECUTE_CWTEST IOCTL

-description

The IOCTL_GNSS_EXECUTE_CWTEST control code is used by the GNSS manufacturing test application to start a carrier wave test and get the measurement. The test application must wait for the result before starting another iteration of the measurement.

-ioctlparameters

-ioctl-major-code

-input-buffer

Set to NULL.

-input-buffer-length

Set to 0.

-output-buffer

A pointer to a GNSS_CWTESTDATA structure.

-output-buffer-length

Set to sizeof(GNSS_CWTESTDATA).

-in-out-buffer

-inout-buffer-length

-status-block

Irp->IoStatus.Status is set to STATUS_SUCCESS if the request is successful. Otherwise, Status to the appropriate error condition as a NTSTATUS code.

-remarks

GNSS test application notes

The test application must ensure that no more than one carrier wave test is started at the same time.

Once the carrier wave test is started, the test application must wait for the result.

The test application will need to repeat this command if it wants to retrieve more than one measurement.

GNSS driver notes

The GNSS driver must fail the new carrier wave test session request if there is already a test in progress.

Once the GNSS driver accepts the carrier wave test session parameters, validates them and starts the detection in the GNSS engine. When the measurements are received, the driver immediately completes the IO with a return code and the measurements.

The GNSS stack must return the measurements as soon as they are available.

-see-also

Creating IOCTL Requests in Drivers

WdfIoTargetSendInternalIoctlOthersSynchronously

WdfIoTargetSendInternalIoctlSynchronously

WdfIoTargetSendIoctlSynchronously