Función AvSetMmMaxThreadCharacteristicsA (avrt.h)

Asocia el subproceso de 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 las 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.

Observaciones

Las características resultantes del subproceso que realizan 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	avrt.h
biblioteca de	Avrt.lib
DLL de	Avrt.dll

Consulte también

del servicio programador de clases multimedia