LearningModelDeviceKind 枚举

定义

命名空间:

Windows.AI.MachineLearning

定义可评估机器学习模型的设备类型的列表。

public enum class LearningModelDeviceKind

/// [Windows.Foundation.Metadata.ContractVersion(Windows.AI.MachineLearning.MachineLearningContract, 65536)]
enum class LearningModelDeviceKind

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.AI.MachineLearning.MachineLearningContract), 65536)]
public enum LearningModelDeviceKind

var value = Windows.AI.MachineLearning.LearningModelDeviceKind.default

Public Enum LearningModelDeviceKind

继承

Enum

LearningModelDeviceKind

属性

ContractVersionAttribute

Windows 要求

设备系列	Windows 10, version 1809 (在 10.0.17763.0 中引入)
API contract	Windows.AI.MachineLearning.MachineLearningContract (在 v1.0 中引入)

字段

Cpu	1	使用 CPU 评估模型。
Default	0	让系统决定要使用哪种设备。
DirectX	2	使用 GPU 或其他 DirectX 设备评估模型。
DirectXHighPerformance	3	使用系统策略定义的设备实现高性能。
DirectXMinPower	4	使用系统策略定义的设备实现最小功率。

示例

以下示例加载模型，选择要评估模型的设备，并创建评估会话。

private async Task LoadModelAsync(string _modelFileName, bool _useGPU)
{
    LearningModel _model;
    LearningModelSession _session;

    try
    {
        // Load and create the model
        var modelFile = 
            await StorageFile.GetFileFromApplicationUriAsync(new Uri($"ms-appx:///Assets/{_modelFileName}"));
        _model = await LearningModel.LoadFromStorageFileAsync(modelFile);

        // Select the device to evaluate on
        LearningModelDevice device = null;
        if (_useGPU)
        {
            // Use a GPU or other DirectX device to evaluate the model.
            device = new LearningModelDevice(LearningModelDeviceKind.DirectX);
        }
        else
        {
            // Use the CPU to evaluate the model.
            device = new LearningModelDevice(LearningModelDeviceKind.Cpu);
        }

        // Create the evaluation session with the model and device.
        _session = new LearningModelSession(_model, device);

    }
    catch (Exception ex)
    {
        StatusBlock.Text = $"error: {ex.Message}";
        _model = null;
    }
}

注解

如果未指定，系统将决定使用哪个设备。

Windows Server

若要在 Windows Server 上使用此 API，必须使用带桌面体验的 Windows Server 2019。

线程安全

此 API 是线程安全的。

另请参阅

• Windows ML
• Windows ML 示例 (GitHub)