Función ExSetFirmwareEnvironmentVariable (wdm.h)
La rutina ExSetFirmwareEnvironmentVariable establece el valor de la variable de entorno de firmware del sistema especificada.
Sintaxis
NTSTATUS ExSetFirmwareEnvironmentVariable(
[in] PUNICODE_STRING VariableName,
[in] LPGUID VendorGuid,
[in] PVOID Value,
[in] ULONG ValueLength,
[in] ULONG Attributes
);
Parámetros
[in] VariableName
Puntero a una estructura de UNICODE_STRING que contiene el nombre de la variable de entorno especificada.
[in] VendorGuid
Puntero a un GUID que identifica al proveedor asociado a la variable de entorno especificada. Las variables de entorno se agrupan en espacios de nombres en función de sus GUID de proveedor. Es posible que algunas plataformas de hardware no admitan GUID de proveedor. En estas plataformas, todas las variables se agrupan en un solo espacio de nombres común y se omite el parámetro VendorGuid .
[in] Value
Puntero a un búfer asignado por el autor de la llamada que contiene el valor de datos que se va a escribir en la variable de entorno especificada.
[in] ValueLength
Tamaño, en bytes, del valor de datos contenido en el búfer valor .
[in] Attributes
Atributos que se van a asignar a la variable de entorno especificada. El bit de atributo VARIABLE_ATTRIBUTE_NON_VOLATILE debe establecerse o se producirá un error en esta llamada. Para obtener más información sobre los bits de atributo definidos para este parámetro, vea Comentarios en ExGetFirmwareEnvironmentVariable.
Valor devuelto
ExSetFirmwareEnvironmentVariable devuelve STATUS_SUCCESS si se realiza correctamente. Entre los posibles valores devueltos se incluyen los siguientes códigos de estado de error.
Código devuelto | Descripción |
---|---|
|
Los recursos del sistema disponibles no son suficientes para completar la operación solicitada. |
|
Uno de los parámetros no es válido. |
|
Esta rutina no se admite en esta plataforma. |
|
El firmware devolvió un error no reconocido. |
Comentarios
El autor de la llamada requiere el privilegio del entorno del sistema (SE_SYSTEM_ENVIRONMENT_PRIVILEGE) para usar esta rutina.
Las variables de entorno de firmware del sistema contienen valores de datos que se pasan entre el entorno de firmware de arranque implementado en la plataforma de hardware y los cargadores del sistema operativo y otro software que se ejecuta en el entorno de firmware. Para obtener más información, vea Comentarios en ExGetFirmwareEnvironmentVariable.
Si crea un almacén de datos de copia de seguridad, puede usar la rutina ExGetFirmwareEnvironmentVariable para guardar toda la configuración de arranque de la plataforma. Más adelante, puede usar ExSetFirmwareEnvironmentVariable para restaurar esta configuración si es necesario.
ExSetFirmwareEnvironmentVariable es el equivalente en modo kernel de la función SetFirmwareEnvironmentVariable de Win32.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Disponible a partir de Windows 8. |
Plataforma de destino | Universal |
Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
Library | NtosKrnl.lib |
Archivo DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
Consulte también
ExGetFirmwareEnvironmentVariable