Instancias del programador

Artículo
02/19/2013

Este documento describe la función de las instancias de programador en el tiempo de ejecución de la concurrencia y cómo utilizar el concurrency::Scheduler y concurrency::CurrentScheduler clases para crear y administrar las instancias de programador.Las instancias de programador son útiles cuando desea asociar directivas de programación explícitas con tipos concretos de cargas de trabajo.Por ejemplo, puede crear una instancia de programador para ejecutar algunas tareas con una prioridad elevada de subproceso y usar el programador predeterminado para ejecutar con otras tareas con la prioridad normal de subproceso.

Sugerencia
El runtime de simultaneidad proporciona un programador predeterminado y, por tanto, no es necesario crear uno en la aplicación.Dado que el programador de tareas ayuda a ajustar el rendimiento de las aplicaciones, se recomienda que comience con Parallel Patterns Library (PPL) o Biblioteca de agentes asincrónicos si no ha usado antes el runtime de simultaneidad.

Secciones

Las clases CurrentScheduler y Scheduler
Crear una instancia del Programador
Administrar la duración de una instancia de programador
Métodos y características
Ejemplo

Las clases CurrentScheduler y Scheduler

El Programador de tareas permite a las aplicaciones utilizar una o varias instancias del programador para programar el trabajo.El concurrency::Scheduler clase representa una instancia de programador y encapsule la funcionalidad relacionada con la planificación de tareas.

Un subproceso que se adjunta a un programador se conoce como contexto de ejecución o simplemente contexto.Un programador puede estar activo en el contexto actual en cualquier momento.El programador activo también es conocido como programador actual.El tiempo de ejecución de simultaneidad se utiliza el concurrency::CurrentScheduler clase para proporcionar acceso al programador de actual.El programador actual de un contexto puede diferir del programador de otro contexto.El runtime no proporciona ninguna representación de nivel de proceso del programador actual.

Normalmente, la clase CurrentScheduler se utiliza para tener acceso al programador actual.La clase Scheduler resulta útil si necesita administrar un programador que no es el actual.

En las siguientes secciones se describe cómo crear y administrar una instancia del programador.Para obtener un ejemplo completo que ilustre estas tareas, vea Cómo: Administrar una instancia del programador.

Top

Crear una instancia del Programador

Hay tres maneras de crear un objeto Scheduler:

Si no existe ningún programador, el runtime crea uno predeterminado para que pueda utilizar la funcionalidad en tiempo de ejecución, por ejemplo, un algoritmo paralelo, para llevar a cabo el trabajo.El programador predeterminado se convierte en el programador actual para el contexto que inicia el trabajo paralelo.
El concurrency::CurrentScheduler::Create método crea un Scheduler objeto que utiliza una directiva específica y que el programador se asocia con el contexto actual.
El concurrency::Scheduler::Create método crea un Scheduler objeto que utiliza una directiva específica, pero no se asocia con el contexto actual.

Permitir que el runtime cree un programador predeterminado posibilita que todas las tareas simultáneas compartan el mismo programador.Normalmente, la funcionalidad que proporciona la Biblioteca de modelos de procesamiento paralelo (PPL) o la Biblioteca de agentes asincrónicos se usa para realizar trabajo paralelo.Por consiguiente, no tiene que trabajar directamente con el programador para controlar su directiva o duración.Al utilizar PPL o la Biblioteca de agentes, el runtime crea el programador predeterminado si no existe y lo convierte en el programador actual para cada contexto.Cuando se crea un programador y se establece como el programador actual, el runtime usa ese programador para programar tareas.Cree instancias adicionales del programador solo cuando necesite una directiva de programación concreta.Para obtener más información sobre las directivas asociadas a un programador, vea Directivas del programador.

Top

Administrar la duración de una instancia de programador

El runtime utiliza un mecanismo de recuento de referencias para controlar la duración de los objetos Scheduler.

Al utilizar el método CurrentScheduler::Create o Scheduler::Create para crear un objeto Scheduler, el runtime establece el recuento de referencias inicial de ese programador en uno.El tiempo de ejecución incrementa el contador de referencias cuando se llama a la concurrency::Scheduler::Attach método.El método Scheduler::Attach asocia el objeto Scheduler junto con el contexto actual.Esto lo convierte en el programador actual.Al llamar al método CurrentScheduler::Create, el tiempo de ejecución crea un objeto Scheduler y lo adjunta al contexto actual (y establece el recuento de referencias en uno).También puede utilizar el concurrency::Scheduler::Reference método para incrementar el recuento de referencias de un Scheduler objeto.

El tiempo de ejecución se reducirá el recuento de referencias cuando se llama a la concurrency::CurrentScheduler::Detach método desasociar el programador de la actual, o llame a la concurrency::Scheduler::Release método.Cuando el recuento de referencias llega a cero, el runtime destruye el objeto Scheduler cuando todas las tareas programadas finalizan.Una tarea en ejecución puede incrementar el recuento de referencias del programador actual.Por consiguiente, si el recuento de referencias llega a cero y una tarea incrementa el recuento de referencias, el runtime no destruye el objeto Scheduler hasta que el recuento de referencias llega a cero de nuevo y finalizan todas las tareas.

El runtime mantiene una pila interna de los objetos Scheduler para cada contexto.Cuando se llama al método CurrentScheduler::Create o Scheduler::Attach, el runtime empuja el objeto Scheduler hacia la pila del contexto actual.Esto lo convierte en el programador actual.Al llamar a CurrentScheduler::Detach, el runtime saca el programador de la pila para el contexto actual y establece el anterior como programador actual.

El runtime proporciona varias maneras de administrar la duración de una instancia del programador.En la siguiente tabla se muestra el método adecuado que libera o desasocia el programador del contexto actual para cada método que crea o adjunta un programador al contexto actual.

Crear o adjuntar	Liberar o desasociar
CurrentScheduler::Create	CurrentScheduler::Detach
Scheduler::Create	Scheduler::Release
Scheduler::Attach	CurrentScheduler::Detach
Scheduler::Reference	Scheduler::Release

Llamar al método de liberar o asociar incorrecto genera un comportamiento no especificado en el runtime.

Cuando usa funcionalidad, por ejemplo, PPL hace que el runtime cree el programador predeterminado, no libera ni desasocia este programador.El runtime administra la duración de cualquier programador que cree.

Debido a que el tiempo de ejecución no se destruye un Scheduler objeto antes de que han terminado de todas las tareas, puede utilizar el concurrency::Scheduler::RegisterShutdownEvent método o la concurrency::CurrentScheduler::RegisterShutdownEvent método para recibir una notificación cuando un Scheduler objeto se destruye.Esto es útil cuando hay que esperar a que finalice cada tarea programada por un objeto Scheduler.

Top

Métodos y características

En esta sección se resumen los métodos importantes de las clases Scheduler y CurrentScheduler.

Piense en la clase CurrentScheduler como una aplicación auxiliar para crear un programador que se usará en el contexto actual.La clase Scheduler permite controlar un programador que pertenece a otro contexto.

En la tabla siguiente se muestran los métodos importantes definidos por la clase CurrentScheduler.

Método	Descripción
Creación	Crea un objeto Scheduler que utiliza la directiva especificada y la asocia con el contexto actual.
Get	Recupera un puntero al objeto Scheduler asociado con los nodos del contexto actual.Este método no incrementa el recuento de referencias del objeto Scheduler.
Desasociar	Desasocia el programador del contexto actual y establece el anterior como programador actual.
RegisterShutdownEvent	Registra un evento que el runtime establece cuando se destruye el programador actual.
CreateScheduleGroup	Crea un concurrency::ScheduleGroup objeto en el programador actual.
ScheduleTask	Agrega una tarea ligera a la cola de programación del programador actual.
GetPolicy	Recupera una copia de la directiva que está asociada al programador actual.

En la tabla siguiente se muestran los métodos importantes definidos por la clase Scheduler.

Método	Descripción
Creación	Crea un objeto Scheduler que usa la directiva especificada.
Asociar	Asocia el objeto Scheduler al contexto actual.
Referencia	Incrementa el contador de referencia del objeto Scheduler.
Versión de lanzamiento	Disminuye el contador de referencia del objeto Scheduler.
RegisterShutdownEvent	Registra un evento que el runtime establece cuando se destruye el objeto Scheduler.
CreateScheduleGroup	Crea un concurrency::ScheduleGroup el objeto en el Scheduler objeto.
ScheduleTask	Programa una tarea ligera del objeto Scheduler.
GetPolicy	Recupera una copia de la directiva que está asociada al objeto Scheduler.
SetDefaultSchedulerPolicy	Establece la directiva que el runtime usa cuando crea el programador predeterminado.
ResetDefaultSchedulerPolicy	Restaura la directiva predeterminada que estaba activa antes de la llamada a SetDefaultSchedulerPolicy.Si el programador predeterminado se crea después de esta llamada, el runtime utiliza los valores de la directiva predeterminada para crear el programador.