# sys.cpu 库模块帮助文档

## sys.cpu 成员列表 <a id="sys.cpu" href="#sys.cpu">&#x23;</a>

### sys.cpu.getBrand() <a id="sys.cpu.getBrand" href="#sys.cpu.getBrand">&#x23;</a>
返回CPU商标信息

### sys.cpu.getFrequence() <a id="sys.cpu.getFrequence" href="#sys.cpu.getFrequence">&#x23;</a>
返回表示 CPU 频率的数值,以 MHz 为单位

### sys.cpu.getFrequence(true) <a id="sys.cpu.getFrequence" href="#sys.cpu.getFrequence">&#x23;</a>
返回表示 CPU 频率的友好格式的字符串,  
单位: GHz 小数位数：1

### sys.cpu.getInfo() <a id="sys.cpu.getInfo" href="#sys.cpu.getInfo">&#x23;</a>
[返回对象:sysCpuInfoObject](#sysCpuInfoObject)

### sys.cpu.getInfo(leaf,subLeaf,outStruct) <a id="sys.cpu.getInfo" href="#sys.cpu.getInfo">&#x23;</a>

```aardio
sys.cpu.getInfo(1/*查询指定索引的 CPU 信息。  
参数 @leaf 指定叶索引（功能码）。  
参数 @subLeaf 可选指定子叶索引（默认为 0）。  
参数 @outStruct 指定 16 字节大小的的结构体，  
省略参数 @outStruct 则默认设为 { INT eax;BYTE ebx[4];BYTE ecx[4];BYTE edx[4] }  
函数返回参数 @2*/)
```

### sys.cpu.getInfoByWmi() <a id="sys.cpu.getInfoByWmi" href="#sys.cpu.getInfoByWmi">&#x23;</a>
使用 WMI 接口类 win32_processor 查询处理器信息  
参考 https://docs.microsoft.com/en-us/windows/win32/cimwin32prov/win32-processor   

[返回对象:sysCpuWmiInfoObject](#sysCpuWmiInfoObject)

### sys.cpu.getIsa() <a id="sys.cpu.getIsa" href="#sys.cpu.getIsa">&#x23;</a>
获取 CPU 支持的所有指令集。  
返回一个表对象，表中包含的所有键名为当前支持的指令集名称。  
所有指令集名称都是大写，名称中的小数点以下划线替代，  
AVX512F（Foundation）返回的键名是 AVX512 。  
此函数不会返回 null 值 并总是返回表对象。  

[返回对象:sysCpuIsaObject](#sysCpuIsaObject)

### sys.cpu.getMaxExtFunction() <a id="sys.cpu.getMaxExtFunction" href="#sys.cpu.getMaxExtFunction">&#x23;</a>
CPU 的扩展信息最大查询索引

### sys.cpu.getVender() <a id="sys.cpu.getVender" href="#sys.cpu.getVender">&#x23;</a>
返回制造商信息,以及CPU基础信息最大查询索引  
Intel会返回"GenuineIntel",  
AMD会返回"AuthenticAMD"

## sysCpuInfoObject 成员列表 <a id="sysCpuInfoObject" href="#sysCpuInfoObject">&#x23;</a>

### sysCpuInfoObject.eax <a id="sysCpuInfoObject.eax" href="#sysCpuInfoObject.eax">&#x23;</a>
整数

### sysCpuInfoObject.ebx <a id="sysCpuInfoObject.ebx" href="#sysCpuInfoObject.ebx">&#x23;</a>
整数

### sysCpuInfoObject.ecx <a id="sysCpuInfoObject.ecx" href="#sysCpuInfoObject.ecx">&#x23;</a>
整数

### sysCpuInfoObject.edx <a id="sysCpuInfoObject.edx" href="#sysCpuInfoObject.edx">&#x23;</a>
整数

## sysCpuIsaObject 成员列表 <a id="sysCpuIsaObject" href="#sysCpuIsaObject">&#x23;</a>

### sysCpuIsaObject.ABM <a id="sysCpuIsaObject.ABM" href="#sysCpuIsaObject.ABM">&#x23;</a>
指令集

### sysCpuIsaObject.AES <a id="sysCpuIsaObject.AES" href="#sysCpuIsaObject.AES">&#x23;</a>
指令集

### sysCpuIsaObject.AVX <a id="sysCpuIsaObject.AVX" href="#sysCpuIsaObject.AVX">&#x23;</a>
指令集

### sysCpuIsaObject.AVX2 <a id="sysCpuIsaObject.AVX2" href="#sysCpuIsaObject.AVX2">&#x23;</a>
指令集

### sysCpuIsaObject.AVX512 <a id="sysCpuIsaObject.AVX512" href="#sysCpuIsaObject.AVX512">&#x23;</a>
指令集

### sysCpuIsaObject.AVX512BW <a id="sysCpuIsaObject.AVX512BW" href="#sysCpuIsaObject.AVX512BW">&#x23;</a>
指令集

### sysCpuIsaObject.AVX512CD <a id="sysCpuIsaObject.AVX512CD" href="#sysCpuIsaObject.AVX512CD">&#x23;</a>
指令集

### sysCpuIsaObject.AVX512DQ <a id="sysCpuIsaObject.AVX512DQ" href="#sysCpuIsaObject.AVX512DQ">&#x23;</a>
指令集

### sysCpuIsaObject.AVX512VBMI <a id="sysCpuIsaObject.AVX512VBMI" href="#sysCpuIsaObject.AVX512VBMI">&#x23;</a>
指令集

### sysCpuIsaObject.AVX512VL <a id="sysCpuIsaObject.AVX512VL" href="#sysCpuIsaObject.AVX512VL">&#x23;</a>
指令集

### sysCpuIsaObject.BMI1 <a id="sysCpuIsaObject.BMI1" href="#sysCpuIsaObject.BMI1">&#x23;</a>
指令集

### sysCpuIsaObject.BMI2 <a id="sysCpuIsaObject.BMI2" href="#sysCpuIsaObject.BMI2">&#x23;</a>
指令集

### sysCpuIsaObject.F16C <a id="sysCpuIsaObject.F16C" href="#sysCpuIsaObject.F16C">&#x23;</a>
指令集

### sysCpuIsaObject.FMA <a id="sysCpuIsaObject.FMA" href="#sysCpuIsaObject.FMA">&#x23;</a>
指令集

### sysCpuIsaObject.FMA4 <a id="sysCpuIsaObject.FMA4" href="#sysCpuIsaObject.FMA4">&#x23;</a>
指令集

### sysCpuIsaObject.MMX <a id="sysCpuIsaObject.MMX" href="#sysCpuIsaObject.MMX">&#x23;</a>
指令集

### sysCpuIsaObject.PCLMULQDQ <a id="sysCpuIsaObject.PCLMULQDQ" href="#sysCpuIsaObject.PCLMULQDQ">&#x23;</a>
指令集

### sysCpuIsaObject.RDRAND <a id="sysCpuIsaObject.RDRAND" href="#sysCpuIsaObject.RDRAND">&#x23;</a>
指令集

### sysCpuIsaObject.SHA <a id="sysCpuIsaObject.SHA" href="#sysCpuIsaObject.SHA">&#x23;</a>
指令集

### sysCpuIsaObject.SSE <a id="sysCpuIsaObject.SSE" href="#sysCpuIsaObject.SSE">&#x23;</a>
指令集

### sysCpuIsaObject.SSE2 <a id="sysCpuIsaObject.SSE2" href="#sysCpuIsaObject.SSE2">&#x23;</a>
指令集

### sysCpuIsaObject.SSE3 <a id="sysCpuIsaObject.SSE3" href="#sysCpuIsaObject.SSE3">&#x23;</a>
指令集

### sysCpuIsaObject.SSE4A <a id="sysCpuIsaObject.SSE4A" href="#sysCpuIsaObject.SSE4A">&#x23;</a>
指令集

### sysCpuIsaObject.SSE4_1 <a id="sysCpuIsaObject.SSE4_1" href="#sysCpuIsaObject.SSE4_1">&#x23;</a>
指令集

### sysCpuIsaObject.SSE4_2 <a id="sysCpuIsaObject.SSE4_2" href="#sysCpuIsaObject.SSE4_2">&#x23;</a>
指令集

### sysCpuIsaObject.SSSE3 <a id="sysCpuIsaObject.SSSE3" href="#sysCpuIsaObject.SSSE3">&#x23;</a>
指令集

### sysCpuIsaObject.XOP <a id="sysCpuIsaObject.XOP" href="#sysCpuIsaObject.XOP">&#x23;</a>
指令集

## sysCpuWmiInfoObject 成员列表 <a id="sysCpuWmiInfoObject" href="#sysCpuWmiInfoObject">&#x23;</a>

### sysCpuWmiInfoObject.* <a id="sysCpuWmiInfoObject.any" href="#sysCpuWmiInfoObject.any">&#x23;</a>
参考 https://docs.microsoft.com/en-us/windows/win32/cimwin32prov/win32-processor

### sysCpuWmiInfoObject.AddressWidth <a id="sysCpuWmiInfoObject.AddressWidth" href="#sysCpuWmiInfoObject.AddressWidth">&#x23;</a>
CPU 位宽,值为 32 或 64

### sysCpuWmiInfoObject.Architecture <a id="sysCpuWmiInfoObject.Architecture" href="#sysCpuWmiInfoObject.Architecture">&#x23;</a>
指令集架构,x86 值为 0,x64 值为 9

### sysCpuWmiInfoObject.CurrentClockSpeed <a id="sysCpuWmiInfoObject.CurrentClockSpeed" href="#sysCpuWmiInfoObject.CurrentClockSpeed">&#x23;</a>
CPU 当前速度,单位 MHz,  
该值除 1000 可换算为单位 GHz  
使用 math.round 可以限定小数位数

### sysCpuWmiInfoObject.DeviceID <a id="sysCpuWmiInfoObject.DeviceID" href="#sysCpuWmiInfoObject.DeviceID">&#x23;</a>
设备 ID

### sysCpuWmiInfoObject.Manufacturer <a id="sysCpuWmiInfoObject.Manufacturer" href="#sysCpuWmiInfoObject.Manufacturer">&#x23;</a>
生产厂商,例如"GenuineIntel"

### sysCpuWmiInfoObject.MaxClockSpeed <a id="sysCpuWmiInfoObject.MaxClockSpeed" href="#sysCpuWmiInfoObject.MaxClockSpeed">&#x23;</a>
CPU 最大速度,单位 MHz,  
该值除 1000 可换算为单位 GHz

### sysCpuWmiInfoObject.Name <a id="sysCpuWmiInfoObject.Name" href="#sysCpuWmiInfoObject.Name">&#x23;</a>
设备名

### sysCpuWmiInfoObject.NumberOfCores <a id="sysCpuWmiInfoObject.NumberOfCores" href="#sysCpuWmiInfoObject.NumberOfCores">&#x23;</a>
CPU 核心数

### sysCpuWmiInfoObject.NumberOfLogicalProcessors <a id="sysCpuWmiInfoObject.NumberOfLogicalProcessors" href="#sysCpuWmiInfoObject.NumberOfLogicalProcessors">&#x23;</a>
CPU 逻辑核心数
