Freigeben über

IOCTL_NFCSE_SET_ROUTING_TABLE IOCTL (nfcsedev.h)

  • Artikel

Konfiguriert die Routingtabelle für den NFC-Controller-Listenmodus. Beachten Sie, dass anrufer vollständige Routinginformationen im Listenmodus in einem einzelnen Anruf senden müssen. Der Anrufer stellt sicher, dass die Routingtabelle kleiner als der cbMaxRoutingTableSize-Wert ist, der in 4.2.5.1 definiert ist. Die Gesamtgröße wird gemäß NFC NCI-Standard sek. 6.3.2 berechnet und entspricht der Anzahl der AID-basierten Routen x 4 + Summe von cbAid + Anzahl der technologiebasierten Routen x 5 + Anzahl der protokollbasierten Routen x 5. Der Aufrufer stellt sicher, dass die Werte für technologie- und protokollbasierte Routen den NCI NFC-Spezifikation s. 6.3.2 entsprechen.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

SECURE_ELEMENT_ROUTING_TABLE alle aktuell konfigurierten Routingeinträge enthalten.

Ausgabepuffer

Nichts

Statusblock

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

Rückgabecode Beschreibung
STATUS_INVALID_BUFFER_SIZE Der bereitgestellte Puffer war größer als der NFC-Controller MAX_ROUTING_TABLE_SIZE.
STATUS_FEATURE_NOT_SUPPORTED Die NFCC unterstützt keine Routingkonfiguration für den Listenmodus.
STATUS_INVALID_PARAMETER Dieser Status wird zurückgegeben, wenn der Ausgabepuffer ungleich Null ist oder Werte, die für Technologie oder Protokoll verwendet werden, den NFC-NCI-Spezifikations sek. 6.3.2 entsprechen oder wenn doppelte AIDs verwendet werden, oder wenn der Routingmodus verwendet wird, der von den aktuellen NFC-Controllerfunktionen nicht unterstützt wird.
STATUS_INVALID_DEVICE_STATE Dieser Code wird zurückgegeben, wenn die IOCTL auf einem anderen Handle als dem relativen Namen "SEManage" gesendet wird.

Bemerkungen

Im Folgenden sind die Anforderungen aufgeführt, die der Treiber einhalten muss.

  • Diese IOCTL wird auf einem Handle mit einem relativen Dateinamen "SEManage" gesendet, andernfalls muss der Treiber es mit STATUS_INVALID_DEVICE_STATE abschließen.
  • Der Fahrer muss über anfängliche Listenmodusroutingtabelleneinträge verfügen, die RF-Technologien A, B und F und/oder ISO-DEP Protokoll weiterleiten, das bei Bedarf an die UICC SE weitergeleitet wird. Diese Routingeinträge können später durch die neue Routingtabellenkonfiguration im Listenmodus außer Kraft gesetzt werden, die vom Gerätehost initiiert wurde.
  • Der Treiber stellt sicher, dass das Protokoll NFC-DEP jederzeit dem Gerätehost zugeordnet ist. Selbst wenn der Aufrufer dies nicht angibt, muss der Treiber diese Regel implizit hinzufügen.
  • Wenn diese IOCTL ausgegeben wird, wenn sich der NFCC im RF-Ermittlungszustand befindet, muss der Treiber die NFCC in den RF-Leerlaufzustand versetzen, die Routingtabelle konfigurieren und die RF-Ermittlung neu starten.

Anforderungen

Anforderung Wert
Header- nfcsedev.h