NVML API 参考指南 (PDF) - vR570 (旧版本) - 上次更新时间:2025 年 1 月 29 日 - 发送反馈

4.32.1. vGPU 枚举

[vGPU 枚举、常量、结构体]

宏定义

#define NVML_GRID_LICENSE_EXPIRY_INVALID 1
无效的到期时间或获取到期时间时出错。
#define NVML_GRID_LICENSE_EXPIRY_NOT_APPLICABLE 3
到期不适用。
#define NVML_GRID_LICENSE_EXPIRY_NOT_AVAILABLE 0
到期信息不可用。
#define NVML_GRID_LICENSE_EXPIRY_PERMANENT 4
永久到期。
#define NVML_GRID_LICENSE_EXPIRY_VALID 2
有效的到期时间。

枚举

enum nvmlDeviceVgpuCapability_t
enum nvmlGpuVirtualizationMode_t
enum nvmlGridLicenseFeatureCode_t
enum nvmlHostVgpuMode_t
enum nvmlVgpuCapability_t
enum nvmlVgpuDriverCapability_t
enum nvmlVgpuGuestInfoState_t
enum nvmlVgpuVmIdType_t

宏定义

#define NVML_GRID_LICENSE_EXPIRY_INVALID 1

#define NVML_GRID_LICENSE_EXPIRY_NOT_APPLICABLE 3

#define NVML_GRID_LICENSE_EXPIRY_NOT_AVAILABLE 0

许可证到期状态代码

#define NVML_GRID_LICENSE_EXPIRY_PERMANENT 4

#define NVML_GRID_LICENSE_EXPIRY_VALID 2

枚举

enum nvmlDeviceVgpuCapability_t

设备 vGPU 可查询功能

NVML_DEVICE_VGPU_CAP_FRACTIONAL_MULTI_VGPU = 0
查询此 GPU 上的 fractional vGPU 配置文件是否可以在 multi-vGPU 配置中使用。
NVML_DEVICE_VGPU_CAP_HETEROGENEOUS_TIMESLICE_PROFILES = 1
查询 GPU 是否支持并发执行不同类型的 timesliced vGPU 配置文件。
NVML_DEVICE_VGPU_CAP_HETEROGENEOUS_TIMESLICE_SIZES = 2
查询 GPU 是否支持并发执行不同帧缓冲区大小的 timesliced vGPU 配置文件。
NVML_DEVICE_VGPU_CAP_READ_DEVICE_BUFFER_BW = 3
查询 GPU 的 read_device_buffer 预期带宽容量,单位为兆字节/秒。
NVML_DEVICE_VGPU_CAP_WRITE_DEVICE_BUFFER_BW = 4
查询 GPU 的 write_device_buffer 预期带宽容量,单位为兆字节/秒。
NVML_DEVICE_VGPU_CAP_DEVICE_STREAMING = 5
查询 GPU 上的 vGPU 配置文件是否支持迁移数据流式传输。
NVML_DEVICE_VGPU_CAP_MINI_QUARTER_GPU = 6
设置/获取对 mini-quarter vGPU 配置文件的支持。
NVML_DEVICE_VGPU_CAP_COMPUTE_MEDIA_ENGINE_GPU = 7
设置/获取对 compute media engine vGPU 配置文件的支持。
NVML_DEVICE_VGPU_CAP_WARM_UPDATE = 8
查询 GPU 是否支持 FSR 和 warm update。
NVML_DEVICE_VGPU_CAP_HOMOGENEOUS_PLACEMENTS = 9
查询 GPU 是否支持报告具有相同帧缓冲区大小的 timesliced vGPU 配置文件的放置位置。
NVML_DEVICE_VGPU_CAP_COUNT
enum nvmlGpuVirtualizationMode_t

GPU 虚拟化模式类型。

NVML_GPU_VIRTUALIZATION_MODE_NONE = 0
表示裸金属 GPU。
NVML_GPU_VIRTUALIZATION_MODE_PASSTHROUGH = 1
设备与 GPU 直通相关联。
NVML_GPU_VIRTUALIZATION_MODE_VGPU = 2
设备与虚拟机内部的 vGPU 相关联。
NVML_GPU_VIRTUALIZATION_MODE_HOST_VGPU = 3
设备与 vGPU 模式下的 VGX 虚拟机监控程序相关联。
NVML_GPU_VIRTUALIZATION_MODE_HOST_VSGA = 4
设备与 vSGA 模式下的 VGX 虚拟机监控程序相关联。
enum nvmlGridLicenseFeatureCode_t

vGPU 软件可许可功能

NVML_GRID_LICENSE_FEATURE_CODE_UNKNOWN = 0
未知。
NVML_GRID_LICENSE_FEATURE_CODE_VGPU = 1
虚拟 GPU。
NVML_GRID_LICENSE_FEATURE_CODE_NVIDIA_RTX = 2
Nvidia RTX。
NVML_GRID_LICENSE_FEATURE_CODE_VWORKSTATION = NVML_GRID_LICENSE_FEATURE_CODE_NVIDIA_RTX
已弃用,请勿使用。
NVML_GRID_LICENSE_FEATURE_CODE_GAMING = 3
游戏。
NVML_GRID_LICENSE_FEATURE_CODE_COMPUTE = 4
计算。
enum nvmlHostVgpuMode_t

主机 vGPU 模式

NVML_HOST_VGPU_MODE_NON_SRIOV = 0
非 SR-IOV 模式。
NVML_HOST_VGPU_MODE_SRIOV = 1
SR-IOV 模式。
enum nvmlVgpuCapability_t

vGPU 可查询功能

NVML_VGPU_CAP_NVLINK_P2P = 0
支持通过 NVLink 进行 P2P。
NVML_VGPU_CAP_GPUDIRECT = 1
支持 GPUDirect 功能。
NVML_VGPU_CAP_MULTI_VGPU_EXCLUSIVE = 2
vGPU 配置文件不能与同一 VM 中的其他 vGPU 配置文件混合使用
NVML_VGPU_CAP_EXCLUSIVE_TYPE = 3
vGPU 配置文件不能与 GPU 上其他不同类型的配置文件一起运行
NVML_VGPU_CAP_EXCLUSIVE_SIZE = 4
vGPU 配置文件不能与 GPU 上其他不同大小的配置文件一起运行
NVML_VGPU_CAP_COUNT
enum nvmlVgpuDriverCapability_t

vGPU 驱动程序可查询功能

NVML_VGPU_DRIVER_CAP_HETEROGENEOUS_MULTI_VGPU = 0
支持在一个客户虚拟机中混合使用不同的 vGPU 配置文件。
NVML_VGPU_DRIVER_CAP_WARM_UPDATE = 1
支持 FSR 和 vGPU 主机驱动程序的 warm update,而无需终止正在运行的客户虚拟机。
NVML_VGPU_DRIVER_CAP_COUNT
enum nvmlVgpuGuestInfoState_t

vGPU GUEST 信息状态

NVML_VGPU_INSTANCE_GUEST_INFO_STATE_UNINITIALIZED = 0
依赖于 Guest 的字段未初始化。
NVML_VGPU_INSTANCE_GUEST_INFO_STATE_INITIALIZED = 1
依赖于 Guest 的字段已初始化。
enum nvmlVgpuVmIdType_t

VM 标识符类型

NVML_VGPU_VM_ID_DOMAIN_ID = 0
VM ID 表示 DOMAIN ID。
NVML_VGPU_VM_ID_UUID = 1
VM ID 表示 UUID。

NVML API 参考指南 (PDF) - vR570 (旧版本) - 上次更新时间:2025 年 1 月 29 日 - 发送反馈