ExecutionProviderCatalog Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece métodos para descobrir, adquirir e registrar EPs (provedores de execução de IA) para uso com o OnNX Runtime.
ExecutionProviderCatalog manipula a complexidade do gerenciamento de pacotes e da seleção de hardware, e é o ponto de entrada para seu aplicativo acessar a aceleração de machine learning com otimização de hardware por meio do runtime do Windows ML.
public ref class ExecutionProviderCatalog sealed/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Windows.AI.MachineLearning.MachineLearningContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ExecutionProviderCatalog final[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Windows.AI.MachineLearning.MachineLearningContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ExecutionProviderCatalogPublic NotInheritable Class ExecutionProviderCatalog- Herança
- Atributos
Exemplos
// Get the default catalog
var catalog = Microsoft.Windows.AI.MachineLearning.ExecutionProviderCatalog.GetDefault();
// Ensure and register all compatible execution providers
await catalog.EnsureAndRegisterCertifiedAsync();
// Use ONNX Runtime directly for inference (using Microsoft.ML.OnnxRuntime namespace)
// Get the default catalog
winrt::Microsoft::Windows::AI::MachineLearning::ExecutionProviderCatalog catalog =
winrt::Microsoft::Windows::AI::MachineLearning::ExecutionProviderCatalog::GetDefault();
// Ensure and register all compatible execution providers
catalog.EnsureAndRegisterCertifiedAsync().get();
// Use ONNX Runtime C API directly for inference
import winui3.microsoft.windows.ai.machinelearning as winml
# Get the default catalog
catalog = winml.ExecutionProviderCatalog.get_default()
# DO NOT call winml's register methods in Python. Those will not work for the onnxruntime Python environment.
# Instead, register execution providers following this pattern:
providers = catalog.find_all_providers()
for provider in providers:
provider.ensure_ready_async().get()
ort.register_execution_provider_library(provider.name, provider.library_path)
Métodos
| Nome | Description |
|---|---|
| EnsureAndRegisterCertifiedAsync() |
Fornece métodos para descobrir, adquirir e registrar EPs (provedores de execução de IA) para uso com o OnNX Runtime. ExecutionProviderCatalog manipula a complexidade do gerenciamento de pacotes e da seleção de hardware, e é o ponto de entrada para seu aplicativo acessar a aceleração de machine learning com otimização de hardware por meio do runtime do Windows ML. |
| FindAllProviders() |
Recupera uma coleção de todos os provedores de execução compatíveis com o hardware atual. |
| GetDefault() |
Recupera a instância de ExecutionProviderCatalog padrão que fornece acesso a todos os provedores de execução no sistema. |
| RegisterCertifiedAsync() |
Registra todos os provedores de execução compatíveis com o OnNX Runtime sem garantir que eles estejam prontos. Isso registra apenas os provedores que já estão presentes no computador, evitando os tempos de download potencialmente longos que podem ser exigidos por EnsureAndRegisterCertifiedAsync. |