Compartir a través de

Función AvSetMmThreadCharacteristicsA (avrt.h)

  • Artículo

Asocia el subproceso de llamada a la tarea especificada.

Sintaxis

AVRTAPI HANDLE AvSetMmThreadCharacteristicsA(
  [in]      LPCSTR  TaskName,
  [in, out] LPDWORD TaskIndex
);

Parámetros

[in] TaskName

Nombre de la 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

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

Nota

El encabezado avrt.h define AvSetMmThreadCharacteristics 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