Compartir a través de


IOCTL_NFCSE_SET_ROUTING_TABLE IOCTL (nfcsedev.h)

Configura la tabla de enrutamiento del modo de escucha del controlador NFC. Tenga en cuenta que el autor de la llamada tiene que enviar información completa de enrutamiento del modo de escucha en una sola llamada. El autor de la llamada garantizará que la tabla de enrutamiento sea menor que el valor cbMaxRoutingTableSize definido en 4.2.5.1. El tamaño total se calcula según el estándar NCI nfc s 6.3.2 y es igual al número de rutas basadas en AID x 4 + suma de cbAid + Número de rutas basadas en tecnología x 5 + Número de rutas basadas en protocolo x 5. El autor de la llamada garantizará que los valores de las rutas basadas en tecnología y protocolo sean compatibles con la especificación NFC de NCI s 6.3.2.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

SECURE_ELEMENT_ROUTING_TABLE que contiene todas las entradas de enrutamiento configuradas actualmente.

Búfer de salida

Ninguno

Bloque de estado

Irp->ioStatus.Status se establece en STATUS_SUCCESS si la solicitud se realiza correctamente. Los códigos de error posibles son:

Código devuelto Descripción
STATUS_INVALID_BUFFER_SIZE El búfer proporcionado era mayor que el MAX_ROUTING_TABLE_SIZE del controlador NFC.
STATUS_FEATURE_NOT_SUPPORTED NFCC no admite la configuración de enrutamiento del modo de escucha.
STATUS_INVALID_PARAMETER Este estado se devuelve si el búfer de salida no es cero, o si se usan valores para tecnología o protocolo es compatible con la especificación NFC NCI s 6.3.2, o si se usan AID duplicados, o cuando se usa el modo de enrutamiento que no es compatible con las funcionalidades actuales del controlador NFC.
STATUS_INVALID_DEVICE_STATE Este código se devuelve si el IOCTL se envía en un identificador distinto de con el nombre relativo "SEManage".

Observaciones

A continuación se muestran los requisitos a los que debe cumplir el controlador.

  • Este IOCTL se envía en un identificador con un nombre de archivo relativo "SEManage", de lo contrario, el controlador DEBE completarlo con STATUS_INVALID_DEVICE_STATE.
  • El controlador tendrá entradas iniciales predeterminadas de la tabla de enrutamiento del modo de escucha que enrutan las tecnologías de RF A, B y F o ISO-DEP protocolo enrutados a UICC SE si están presentes. Estas entradas de enrutamiento pueden invalidarse posteriormente mediante la nueva configuración de tabla de enrutamiento del modo de escucha iniciada por el host del dispositivo.
  • El controlador se asegurará de que el protocolo NFC-DEP se asigne al host del dispositivo en todo momento. Incluso si el autor de la llamada no especifica esto, el controlador debe agregar esta regla implícitamente.
  • Si este IOCTL se emite cuando NFCC está en estado de detección de RF, el controlador debe poner el NFCC en estado inactivo de RF, configurar la tabla de enrutamiento y reiniciar la detección de RF.

Requisitos

Requisito Valor
encabezado de nfcsedev.h