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 clave siguiente 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 las 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 los 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

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

Nota

El encabezado avrt.h define AvSetMmThreadCharacteristics como un 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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