std.os.uefi.protocol.hii_database.cc
别名
别名目标 std.os.uefi.cc
std.os.uefi.protocol.hii_database.Guid
别名
别名目标 std.os.uefi.Guid
std.os.uefi.protocol.hii_database.hii
别名
别名目标 std.os.uefi.hii
std.os.uefi.protocol.hii_database.HiiDatabase
容器
HII 相关数据结构的数据库管理器。
字段
_new_package_list: Status
_remove_package_list: *const fn (*HiiDatabase, hii.Handle) callconv(cc) Status
_update_package_list: *const fn (*HiiDatabase, hii.Handle, *const hii.PackageList) callconv(cc) Status
_list_package_lists: *const fn (*const HiiDatabase, u8, ?*const Guid, *usize, [*]hii.Handle) callconv(cc) Status
_export_package_lists: *const fn (*const HiiDatabase, ?hii.Handle, *usize, [*]hii.PackageList) callconv(cc) Status
_register_package_notify: Status
_unregister_package_notify: Status
_find_keyboard_layouts: Status
_get_keyboard_layout: Status
_set_keyboard_layout: Status
_get_package_list_handle: Status
std.os.uefi.protocol.hii_database.HiiDatabase.ExportPackageListError
错误集合
错误
- BufferTooSmall
- InvalidParameter
- NotFound
- Unexpected UnexpectedError
std.os.uefi.protocol.hii_database.HiiDatabase.exportPackageLists
函数
将 HII 数据库中一个或所有包列表的内容导出到缓冲区。
pub fn exportPackageLists( self: *const HiiDatabase, handle: ?hii.Handle, buffer: []hii.PackageList, ) ExportPackageListError![]hii.PackageList
参数
错误
- BufferTooSmall
- InvalidParameter
- NotFound
- Unexpected UnexpectedError
std.os.uefi.protocol.hii_database.HiiDatabase.guid
常量
std.os.uefi.protocol.hii_database.HiiDatabase.listPackageLists
函数
确定数据库中当前活动的句柄。
pub fn listPackageLists( self: *const HiiDatabase, package_type: u8, package_guid: ?*const Guid, handles: []hii.Handle, ) ListPackageListsError![]hii.Handle
参数
错误
- BufferTooSmall
- InvalidParameter
- NotFound
- Unexpected UnexpectedError
std.os.uefi.protocol.hii_database.HiiDatabase.ListPackageListsError
错误集合
错误
- BufferTooSmall
- InvalidParameter
- NotFound
- Unexpected UnexpectedError
std.os.uefi.protocol.hii_database.HiiDatabase.removePackageList
函数
从 HII 数据库移除包列表。
pub fn removePackageList(self: *HiiDatabase, handle: hii.Handle) RemovePackageListError!void
参数
self: *HiiDatabase
handle: hii.Handle
错误
- NotFound
- Unexpected UnexpectedError
std.os.uefi.protocol.hii_database.HiiDatabase.RemovePackageListError
错误集合
错误
- NotFound
- Unexpected UnexpectedError
std.os.uefi.protocol.hii_database.HiiDatabase.updatePackageList
函数
更新 HII 数据库中的包列表。
pub fn updatePackageList( self: *HiiDatabase, handle: hii.Handle, buffer: *const hii.PackageList, ) UpdatePackageListError!void
参数
错误
- InvalidParameter
- NotFound
- OutOfResources
- Unexpected UnexpectedError
std.os.uefi.protocol.hii_database.HiiDatabase.UpdatePackageListError
错误集合
错误
- InvalidParameter
- NotFound
- OutOfResources
- Unexpected UnexpectedError
std.os.uefi.protocol.hii_database.Status
别名
别名目标 std.os.uefi.Status
std.os.uefi.protocol.hii_database.std
别名
别名目标 std
std.os.uefi.protocol.hii_database.uefi
别名
别名目标 std.os.uefi
源码
std/os/uefi/protocol/hii_database.zig
const std = @import("std");
const uefi = std.os.uefi;
const Guid = uefi.Guid;
const Status = uefi.Status;
const hii = uefi.hii;
const cc = uefi.cc;
/// HII 相关数据结构的数据库管理器。
pub const HiiDatabase = extern struct {
_new_package_list: Status, // TODO
_remove_package_list: *const fn (*HiiDatabase, hii.Handle) callconv(cc) Status,
_update_package_list: *const fn (*HiiDatabase, hii.Handle, *const hii.PackageList) callconv(cc) Status,
_list_package_lists: *const fn (*const HiiDatabase, u8, ?*const Guid, *usize, [*]hii.Handle) callconv(cc) Status,
_export_package_lists: *const fn (*const HiiDatabase, ?hii.Handle, *usize, [*]hii.PackageList) callconv(cc) Status,
_register_package_notify: Status, // TODO
_unregister_package_notify: Status, // TODO
_find_keyboard_layouts: Status, // TODO
_get_keyboard_layout: Status, // TODO
_set_keyboard_layout: Status, // TODO
_get_package_list_handle: Status, // TODO
pub const RemovePackageListError = uefi.UnexpectedError || error{NotFound};
pub const UpdatePackageListError = uefi.UnexpectedError || error{
OutOfResources,
InvalidParameter,
NotFound,
};
pub const ListPackageListsError = uefi.UnexpectedError || error{
BufferTooSmall,
InvalidParameter,
NotFound,
};
pub const ExportPackageListError = uefi.UnexpectedError || error{
BufferTooSmall,
InvalidParameter,
NotFound,
};
/// 从 HII 数据库移除包列表。
pub fn removePackageList(self: *HiiDatabase, handle: hii.Handle) RemovePackageListError!void {
switch (self._remove_package_list(self, handle)) {
.success => {},
.not_found => return error.NotFound,
else => |status| return uefi.unexpectedStatus(status),
}
}
/// 更新 HII 数据库中的包列表。
pub fn updatePackageList(
self: *HiiDatabase,
handle: hii.Handle,
buffer: *const hii.PackageList,
) UpdatePackageListError!void {
switch (self._update_package_list(self, handle, buffer)) {
.success => {},
.out_of_resources => return error.OutOfResources,
.invalid_parameter => return error.InvalidParameter,
.not_found => return error.NotFound,
else => |status| return uefi.unexpectedStatus(status),
}
}
/// 确定数据库中当前活动的句柄。
pub fn listPackageLists(
self: *const HiiDatabase,
package_type: u8,
package_guid: ?*const Guid,
handles: []hii.Handle,
) ListPackageListsError![]hii.Handle {
var len: usize = handles.len;
switch (self._list_package_lists(
self,
package_type,
package_guid,
&len,
handles.ptr,
)) {
.success => return handles[0..len],
.buffer_too_small => return error.BufferTooSmall,
.invalid_parameter => return error.InvalidParameter,
.not_found => return error.NotFound,
else => |status| return uefi.unexpectedStatus(status),
}
}
/// 将 HII 数据库中一个或所有包列表的内容导出到缓冲区。
pub fn exportPackageLists(
self: *const HiiDatabase,
handle: ?hii.Handle,
buffer: []hii.PackageList,
) ExportPackageListError![]hii.PackageList {
var len = buffer.len;
switch (self._export_package_lists(self, handle, &len, buffer.ptr)) {
.success => return buffer[0..len],
.buffer_too_small => return error.BufferTooSmall,
.invalid_parameter => return error.InvalidParameter,
.not_found => return error.NotFound,
else => |status| return uefi.unexpectedStatus(status),
}
}
pub const guid align(8) = Guid{
.time_low = 0xef9fc172,
.time_mid = 0xa1b2,
.time_high_and_version = 0x4693,
.clock_seq_high_and_reserved = 0xb3,
.clock_seq_low = 0x27,
.node = [_]u8{ 0x6d, 0x32, 0xfc, 0x41, 0x60, 0x42 },
};
};