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 |
|---|---|
|
TaskIndex no es 0 en la primera llamada o no se reconoce el valor (en llamadas posteriores). |
|
La tarea especificada no coincide con ninguna de las tareas almacenadas en el Registro. |
|
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 |