EFI_RNG_PROTOCOL. GetInfo

Artículo
06/15/2023

Devuelve información sobre los algoritmos RNG admitidos por un controlador que implementa EFI_RNG_PROTOCOL.

Sintaxis

typedef
EFI_STATUS
(EFIAPI *EFI_RNG_GET_INFO) (
    IN  struct _EFI_RNG_PROTOCOL    *This,
    IN  OUT UINTN                   *RNGAlgorithmListSize,
    OUT EFI_RNG_ALGORITHM           *RNGAlgorithmList
    );

Parámetros

Éste
[in] Puntero a la instancia de EFI_RNG_PROTOCOL .

RNGAlgorithmListSize
[dentro, fuera] Número de algoritmos en RNGAlgorithmList.

RNGAlgorithmList
[out] Puntero a una lista de EFI_RNG_ALGORITHM valores que representan algoritmos RNG. Cada algoritmo tiene sizeof(EFI_GUID) un largo de bytes.

Observaciones

Un controlador que implementa EFI_RNG_PROTOCOL puede admitir uno o varios algoritmos RNG.

El valor devuelto por el parámetro RNGAlgorithmList no debe cambiar en varias llamadas al mismo controlador. El primer algoritmo de la lista es el algoritmo predeterminado para el controlador.

Esta función asigna la lista de algoritmos mediante EFI_BOOT_SERVICES-AllocatePool>() y es responsabilidad del autor de la llamada liberar esta lista mediante EFI_BOOT_SERVICES-FreePool>().

Valor devuelto

Devuelve uno de los siguientes códigos de estado.

status code	Descripción
EFI_SUCCESS	La función recuperó correctamente la lista de algoritmos RNG.
EFI_UNSUPPORTED	Este controlador no admite el servicio.
EFI_DEVICE_ERROR	No se pudo recuperar la lista de algoritmos RNG debido a un error de hardware o firmware.
EFI_OUT_OF_RESOURCES	El controlador no puede asignar memoria para el parámetro RNGAlgorithmList .

Requisitos

Rúbrica: Usuario generado

Compartir vía