IOCTL_NFCSE_ENUM_ENDPOINTS IOCTL (nfcsedev.h)

Devuelve información relacionada con 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 sobre todos los elementos seguros enumerados por el controlador, es decir, el número total de SEs Enumerados x Size de la información del punto de conexión SE de lo contrario, el controlador debe devolver un código de error de 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

Ninguno

Longitud del búfer de entrada

Ninguno

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:

Observaciones

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 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 la 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