EFI_RNG_PROTOCOL. Getinfo

Artikel
06/15/2023

Gibt Informationen zu den RNG-Algorithmen zurück, die von einem Treiber unterstützt werden, der EFI_RNG_PROTOCOL implementiert.

Syntax

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

Parameter

Dieser
[in] Ein Zeiger auf die EFI_RNG_PROTOCOL instance.

RNGAlgorithmListSize
[ein, aus] Die Anzahl der Algorithmen in RNGAlgorithmList.

RNGAlgorithmList
[out] Ein Zeiger auf eine Liste von EFI_RNG_ALGORITHM Werten, die RNG-Algorithmen darstellen. Jeder Algorithmus ist sizeof(EFI_GUID) Bytes lang.

Bemerkungen

Ein Treiber, der EFI_RNG_PROTOCOL implementiert, kann einen oder mehrere RNG-Algorithmen unterstützen.

Der vom RNGAlgorithmList-Parameter zurückgegebene Wert darf sich nicht über mehrere Aufrufe desselben Treibers ändern. Der erste Algorithmus in der Liste ist der Standardalgorithmus für den Treiber.

Die Liste der Algorithmen wird von dieser Funktion mithilfe von EFI_BOOT_SERVICES-AllocatePool>() zugeordnet, und es liegt in der Verantwortung des Aufrufers, diese Liste mithilfe von EFI_BOOT_SERVICES-FreePool>() freizugeben.

Rückgabewert

Gibt einen der folgenden status-Codes zurück.

Statuscode	BESCHREIBUNG
EFI_SUCCESS	Die Funktion hat die Liste der RNG-Algorithmen erfolgreich abgerufen.
EFI_UNSUPPORTED	Der Dienst wird von diesem Treiber nicht unterstützt.
EFI_DEVICE_ERROR	Die Liste der RNG-Algorithmen konnte aufgrund eines Hardware- oder Firmwarefehlers nicht abgerufen werden.
EFI_OUT_OF_RESOURCES	Der Treiber kann keinen Arbeitsspeicher für den RNGAlgorithmList-Parameter zuweisen.

Anforderungen

Header: Benutzer generiert

Freigeben über