IOCTL_NFCSE_ENUM_ENDPOINTS IOCTL (nfcsedev.h)

  • Artículo

Devuelve información sobre la lista de todos los elementos seguros adjuntos al controlador NFC. Tenga en cuenta que el autor de la llamada debe asignar un búfer de salida lo suficientemente grande como para contener información relacionada con todos los elementos seguros enumerados por el controlador, es decir, el número total de SEs Enumerado x Size de la información del punto de conexión se debe devolver un código de error STATUS_BUFFER_OVERFLOW al cliente con el campo NumberOfEndpoints que contiene el número de elementos seguros enumerados. GUID que identifica el elemento seguro que tal vez se usa para hacer referencia a un elemento seguro determinado.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

None

Longitud del búfer de entrada

None

Búfer de salida

Un SECURE_ELEMENT_ENDPOINT_LIST para cada dispositivo enumerado.

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 de retorno Descripción
STATUS_INVALID_PARAMETER Este código se devuelve cuando el búfer de salida es distinto de cero.
STATUS_BUFFER_OVERFLOW El búfer proporcionado era demasiado pequeño para recibir la configuración de la tabla de enrutamiento.

Comentarios

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

  • En el caso del elemento seguro integrado, el GUID será un identificador único derivado del número de serie y/o de otra identificación única del elemento seguro.
  • En el caso de los elementos seguros externos, el GUID puede ser una constante fija e identifica solo el "socket" en el que está conectado el elemento seguro.
  • En el caso del elemento seguro host del dispositivo, el controlador lo enumerará como punto de conexión SE solo si admite emulación de tarjeta host. El GUID usado para DH puede ser una constante fija definida por el controlador.
  • El autor de la llamada es necesario para asignar un búfer de salida lo suficientemente grande como para contener la información sobre todos los elementos seguros enumerados por el controlador. El búfer debe ser igual al número total de SEs enumerados por el controlador multiplicado por el tamaño de la información del punto de conexión se. Si no se asigna el búfer adecuado, el controlador devuelve un código de error STATUS_BUFFER_OVERFLOW al cliente con el campo NumberOfEndpoints que contiene el número de elementos seguros enumerados.

Requisitos

Requisito Valor
Header nfcsedev.h