IOCTL_NFCSE_GET_ROUTING_TABLE IOCTL (nfcsedev.h)

  • Artikel

Gibt Informationen zur aktuellen Konfiguration der Routingtabelle für den Listenmodus zurück. Beachten Sie, dass der Aufrufer einen Ausgabepuffer zuordnen muss, der groß genug ist, um Informationen zu allen Einträgen zu enthalten, die in der aktuellen Routingmodusroutingtabelle vorhanden sind, d. h. Gesamtanzahl der Routingeinträge x Größe des Routingtabelleneintrags. 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 nicht den Eintrag zurückgeben, der NFC-DEP an DH als Teil der Routingtabelle im Ausgabepuffer zurückgibt, obwohl der Eintrag in der NFCC-Routingtabelle vorhanden ist.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Keine

Eingabepufferlänge

Keine

Ausgabepuffer

SECURE_ELEMENT_ROUTING_TABLE , die alle aktuell konfigurierten Routingeinträge enthalten.

Länge des Ausgabepuffers

sizeof(SECURE_ELEMENT_ROUTING_TABLE)

Statusblock

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

Code zurückgeben 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 0 ist.
STATUS_INVALID_DEVICE_STATE Dieser Code wird zurückgegeben, wenn die IOCTL an einem anderen Handle als mit dem relativen Namen "SEManage" gesendet wird.

Anforderungen

Anforderung Wert
Header nfcsedev.h