IOCTL_GNSS_EXECUTE_CWTEST IOCTL (gnssdriver.h)

Artikel
02/29/2024

Der IOCTL_GNSS_EXECUTE_CWTEST Steuercode wird von der Testanwendung für die GNSS-Fertigung verwendet, um einen Trägerwellentest zu starten und die Messung zu erhalten. Die Testanwendung muss auf das Ergebnis warten, bevor eine weitere Iteration der Messung gestartet wird.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Auf NULL festgelegt.

Länge des Eingabepuffers

Auf 0 festlegen.

Ausgabepuffer

Ein Zeiger auf eine GNSS_CWTESTDATA-Struktur .

Länge des Ausgabepuffers

Auf sizeof(GNSS_CWTESTDATA) festgelegt.

Statusblock

Irp->IoStatus.Status wird auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Andernfalls wird Status zur entsprechenden Fehlerbedingung als NTSTATUS-Code verwendet.

Hinweise

Hinweise zur GNSS-Testanwendung

Die Testanwendung muss sicherstellen, dass nicht mehr als ein Trägerwellentest gleichzeitig gestartet wird.

Nachdem der Trägerwellentest gestartet wurde, muss die Testanwendung auf das Ergebnis warten.

Die Testanwendung muss diesen Befehl wiederholen, wenn sie mehr als eine Messung abrufen möchte.

Hinweise zu GNSS-Treibern

Der GNSS-Treiber muss die neue Anforderung der Carrier Wave-Testsitzung fehlschlagen, wenn bereits ein Test ausgeführt wird.

Sobald der GNSS-Treiber die Parameter der Carrier Wave-Testsitzung akzeptiert, überprüft sie und startet die Erkennung in der GNSS-Engine. Wenn die Messungen empfangen werden, schließt der Treiber sofort die E/A mit einem Rückgabecode und den Messungen ab.

Der GNSS-Stapel muss die Messungen zurückgeben, sobald sie verfügbar sind.