Función AvSetMmMaxThreadCharacteristicsA (avrt.h)

Asocia el subproceso que realiza la llamada a las tareas especificadas.

Sintaxis

AVRTAPI HANDLE AvSetMmMaxThreadCharacteristicsA(
  [in]      LPCSTR  FirstTask,
  [in]      LPCSTR  SecondTask,
  [in, out] LPDWORD TaskIndex
);

Parámetros

[in] FirstTask

Nombre de la primera tarea que se va a realizar. Este nombre debe coincidir con el nombre de una de las subclaves de la siguiente clave HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Multimedia\SystemProfile\Tasks.

[in] SecondTask

Nombre de la segunda tarea que se va a realizar. Este nombre debe coincidir con el nombre de una de las subclaves de la siguiente clave HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Multimedia\SystemProfile\Tasks.

[in, out] TaskIndex

Identificador de tarea único. La primera vez que se llama a esta función, este valor debe ser 0 en la entrada. El valor de índice se devuelve en la salida y se puede usar como entrada en llamadas posteriores.

Valor devuelto

Si la función se ejecuta correctamente, devuelve un identificador a la tarea.

Si se produce un error en la función, devuelve 0. Para recuperar información de error extendida, llame a GetLastError.

A continuación se muestran códigos de error posibles.

Código devuelto	Descripción
ERROR_INVALID_TASK_INDEX	TaskIndex no es 0 en la primera llamada o no se reconoce el valor (en llamadas posteriores).
ERROR_INVALID_TASK_NAME	La tarea especificada no coincide con ninguna de las tareas almacenadas en el Registro.
ERROR_PRIVILEGE_NOT_HELD	El autor de la llamada no tiene privilegios suficientes.

Comentarios

Las características resultantes del subproceso que realiza las tareas reflejan la tarea con la prioridad más alta.

Cuando se complete la tarea, llame a la función AvRevertMmThreadCharacteristics .

Nota

El encabezado avrt.h define AvSetMmMaxThreadCharacteristics como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	avrt.h
Library	Avrt.lib
Archivo DLL	Avrt.dll

Consulte también

Servicio de programador de clases multimedia