ExecutionProviderCatalog Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce metodi per individuare, acquisire e registrare provider di esecuzione di intelligenza artificiale per l'uso con il runtime ONNX.
ExecutionProviderCatalog gestisce la complessità della gestione dei pacchetti e della selezione hardware ed è il punto di ingresso per l'app per accedere all'accelerazione di Machine Learning ottimizzata per l'hardware tramite il runtime di Machine Learning Windows.
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 ExecutionProviderCatalog
Public NotInheritable Class ExecutionProviderCatalog
- Ereditarietà
- Attributi
Esempio
// 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)
Metodi
| Nome | Descrizione |
|---|---|
| EnsureAndRegisterCertifiedAsync() |
Fornisce metodi per individuare, acquisire e registrare provider di esecuzione di intelligenza artificiale per l'uso con il runtime ONNX. ExecutionProviderCatalog gestisce la complessità della gestione dei pacchetti e della selezione hardware ed è il punto di ingresso per l'app per accedere all'accelerazione di Machine Learning ottimizzata per l'hardware tramite il runtime di Machine Learning Windows. |
| FindAllProviders() |
Recupera una raccolta di tutti i provider di esecuzione compatibili con l'hardware corrente. |
| GetDefault() |
Recupera l'istanza predefinita ExecutionProviderCatalog che fornisce l'accesso a tutti i provider di esecuzione nel sistema. |
| RegisterCertifiedAsync() |
Registra tutti i provider di esecuzione compatibili con il runtime ONNX senza assicurarsi che siano pronti. In questo modo vengono registrati solo i provider già presenti nel computer, evitando i tempi di download potenzialmente lunghi che potrebbero essere richiesti da EnsureAndRegisterCertifiedAsync. |