IOCTL_NFCSE_GET_ROUTING_TABLE IOCTL (nfcsedev.h)

Gibt Informationen zur aktuellen Konfiguration der Routingtabelle für den Listenmodus zurück. Beachten Sie, dass der Aufrufer einen Ausgabepuffer groß genug zuweisen muss, um Informationen zu allen Einträgen zu enthalten, die in der aktuellen Routingmodusroutingtabelle vorhanden sind, d. h. die Gesamtanzahl der Routingeinträge x Größe der Routingtabelleneingabe, andernfalls sollte der Treiber einen STATUS_BUFFER_OVERFLOW Fehlercode an den Client mit dem Feld "NumberOfEntries" zurückgeben, das die Anzahl der konfigurierten Routingtabelleneinträge enthält. Der Routingtabelleneintrag ist vom Typ SECURE_ELEMENT_ROUTING_TABLE_ENTRY. Hinweis: Der Treiber sollte keine Eingaberouting-NFC-DEP als Teil der routingtabelle zurückgeben, die im Ausgabepuffer zurückgegeben wird, obwohl der Eintrag in der NFCC-Routingtabelle vorhanden ist.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Nichts

Eingabepufferlänge

Nichts

Ausgabepuffer

SECURE_ELEMENT_ROUTING_TABLE alle aktuell konfigurierten Routingeinträge enthalten.

Länge des Ausgabepuffers

sizeof(SECURE_ELEMENT_ROUTING_TABLE)

Statusblock

Irp->IoStatus.Status wird auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Mögliche Fehlercodes sind:

Rückgabecode	Beschreibung
STATUS_BUFFER_OVERFLOW	Der bereitgestellte Puffer war zu klein, um die Routingtabellenkonfiguration zu empfangen.
STATUS_FEATURE_NOT_SUPPORTED	Die NFCC unterstützt keine Routingkonfiguration für den Listenmodus.
STATUS_INVALID_PARAMETER	Dieser Code wird zurückgegeben, wenn der Eingabepuffer ungleich Null ist.
STATUS_INVALID_DEVICE_STATE	Dieser Code wird zurückgegeben, wenn die IOCTL auf einem anderen Handle als dem relativen Namen "SEManage" gesendet wird.

Anforderungen

Anforderung	Wert
Header-	nfcsedev.h