IOCTL_GNSS_CONFIG_SUPL_CERT IOCTL (gnssdriver.h)
El adaptador de GNSS usa el código de control IOCTL_GNSS_CONFIG_SUPL_CERT para establecer certificados SUPL.
Código principal
Búfer de entrada
Puntero a una estructura de GNSS_SUPL_CERT_CONFIG.
Longitud del búfer de entrada
Establezca en sizeof(GNSS_SUPL_CERT_CONFIG).
Búfer de salida
Establezca en null.
Longitud del búfer de salida
Establezca en 0.
Bloque de estado
Irp->ioStatus.Status se establece en STATUS_SUCCESS si la solicitud se realiza correctamente. De lo contrario, estado a la condición de error adecuada como código NTSTATUS.
Observaciones
El controlador establece uno de los siguientes valores NTSTATUS para indicar el resultado.
- STATUS_SUCCESS, cuando el controlador procesa correctamente la información del certificado SUPL. Si el IOCTL intenta eliminar o purgar certificados que no existen, todavía devuelve STATUS_SUCCESS.
- Error cuando el controlador no procesa correctamente la información del certificado SUPL.
- Se omite cuando el controlador omite la información del certificado SUPL.
Notas del adaptador de GNSS de
Para GNSS DDI versión 1:El adaptador GNSS no necesita hacer nada especial.
Para GNSS DDI versión 2 y posteriores:
El adaptador de GNSS solo hará referencia a certificados por nombre. Será hasta el controlador GNSS para asignar los nombres de certificado internamente a cualquier otra representación o referencia a los certificados, si es necesario.
El adaptador de GNSS realizará una purga completa o todos los certificados insertados previamente si es necesario antes de insertar un nuevo conjunto.
Notas del controlador GNSS de
El controlador GNSS debe pasar esta información de certificado al componente SUPL que debe usar el certificado para configurar una conexión segura con H-SLP.Para GNSS DDI versión 2 y posteriores:
El controlador GNSS debe admitir la recepción de varias llamadas de la IOCTL_GNSS_CONFIG_SUPL_CERT. El adaptador de GNSS llamará a este IOCTL varias veces, cada vez para insertar un certificado raíz diferente. Los distintos certificados raíz se identifican teniendo un SuplCertName diferente, que proporciona el nombre del certificado que se inserta.
- Si el nombre es el mismo que un certificado configurado anteriormente, se reemplazará el certificado.
- Si el nombre es diferente del certificado, se agregará el nuevo certificado.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | gnssdriver.h |
Consulte también
crear solicitudes IOCTL en controladores
WdfIoTargetSendInternalIoctlOthersSynchronously