IOCTL_NFCSE_SET_ROUTING_TABLE IOCTL (nfcsedev.h)

Konfiguriert die Routingtabelle des NFC-Controllers im Lauschmodus. Beachten Sie, dass der Anrufer vollständige Routinginformationen im Listenmodus in einem einzigen Anruf senden muss. Der Aufrufer muss sicherstellen, dass die Routingtabelle kleiner als der in 4.2.5.1 definierte cbMaxRoutingTableSize-Wert ist. Die Gesamtgröße wird gemäß NFC NCI Standard Sec 6.3.2 berechnet und ist gleich Anzahl der AID-basierten Routen x 4 + Summe von cbAid + Anzahl der technologiebasierten Routen x 5 + Anzahl protokollbasierter Routen x 5. Der Aufrufer muss sicherstellen, dass die Werte für technologie- und protokollbasierte Routen mit der NCI-NFC-Spezifikation Sek. 6.3.2 übereinstimmen.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

SECURE_ELEMENT_ROUTING_TABLE , die alle aktuell konfigurierten Routingeinträge enthalten.

Ausgabepuffer

Keine

Statusblock

Irp->IoStatus.Status ist 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 im Lauschmodus.
STATUS_INVALID_PARAMETER Dieser status wird zurückgegeben, wenn der Ausgabepuffer ungleich 0 (null) ist oder die werte, die für Technologie oder Protokoll verwendet werden, mit nfc NCI Spec 6.3.2 konform sind 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 an ein anderes Handle als mit dem relativen Namen "SEManage" gesendet wird.

Hinweise

Im Folgenden sind Die Anforderungen aufgeführt, die der Treiber erfüllen muss.

  • Diese IOCTL wird für ein Handle mit einem relativen Dateinamen "SEManage" gesendet, andernfalls MUSS der Treiber sie mit STATUS_INVALID_DEVICE_STATE abschließen.
  • Der Treiber muss über anfängliche Standardroutingtabelleneinträge im Listenmodus verfügen, die rf-Technologien A, B und F und/oder ISO-DEP-Protokoll weiterleiten, die an UICC SE weitergeleitet werden, sofern vorhanden. Diese Routingeinträge können später von einer neuen, vom Gerätehost initiierten Routingtabellenkonfiguration im Listenmodus überschrieben werden.
  • Der Treiber muss sicherstellen, dass das Protokoll NFC-DEP jederzeit dem Gerätehost zugeordnet wird. Auch wenn der Aufrufer dies nicht angibt, muss der Treiber diese Regel implizit hinzufügen.
  • Wenn diese IOCTL ausgegeben wird, wenn sich die 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