ExecutionProviderCatalog Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona métodos para detectar, adquirir y registrar proveedores de ejecución de INTELIGENCIA ARTIFICIAL (EPs) para su uso con el entorno de ejecución de ONNX.
ExecutionProviderCatalog controla la complejidad de la administración de paquetes y la selección de hardware, y es el punto de entrada para que la aplicación acceda a la aceleración del aprendizaje automático optimizado para hardware a través del entorno de ejecución de ml de 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
- Herencia
- Atributos
Ejemplos
// 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
| Nombre | Description |
|---|---|
| EnsureAndRegisterCertifiedAsync() |
Proporciona métodos para detectar, adquirir y registrar proveedores de ejecución de INTELIGENCIA ARTIFICIAL (EPs) para su uso con el entorno de ejecución de ONNX. ExecutionProviderCatalog controla la complejidad de la administración de paquetes y la selección de hardware, y es el punto de entrada para que la aplicación acceda a la aceleración del aprendizaje automático optimizado para hardware a través del entorno de ejecución de ml de Windows. |
| FindAllProviders() |
Recupera una colección de todos los proveedores de ejecución compatibles con el hardware actual. |
| GetDefault() |
Recupera la instancia de ExecutionProviderCatalog predeterminada que proporciona acceso a todos los proveedores de ejecución del sistema. |
| RegisterCertifiedAsync() |
Registra todos los proveedores de ejecución compatibles con el entorno de ejecución de ONNX sin asegurarse de que están listos. Esto registra solo los proveedores que ya están presentes en la máquina, lo que evita los tiempos de descarga potencialmente largos que podría requerir EnsureAndRegisterCertifiedAsync. |