Condividi tramite


Funzione AvSetMmMaxThreadCharacteristicsA (avrt.h)

Associa il thread chiamante alle attività specificate.

Sintassi

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

Parametri

[in] FirstTask

Nome della prima attività da eseguire. Questo nome deve corrispondere al nome di una delle sottochiavi della chiave seguente HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Multimedia\SystemProfile\Tasks.

[in] SecondTask

Nome della seconda attività da eseguire. Questo nome deve corrispondere al nome di una delle sottochiavi della chiave seguente HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Multimedia\SystemProfile\Tasks.

[in, out] TaskIndex

Identificatore univoco dell'attività. La prima volta che questa funzione viene chiamata, questo valore deve essere 0 all'input. Il valore di indice viene restituito nell'output e può essere usato come input nelle chiamate successive.

Valore restituito

Se la funzione ha esito positivo, restituisce un handle all'attività.

Se la funzione ha esito negativo, restituisce 0. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Di seguito sono riportati i possibili codici di errore.

Codice restituito Descrizione
ERROR_INVALID_TASK_INDEX
TaskIndex non è 0 nella prima chiamata o non è riconosciuto (nelle chiamate successive).
ERROR_INVALID_TASK_NAME
L'attività specificata non corrisponde ad alcuna attività archiviata nel Registro di sistema.
ERROR_PRIVILEGE_NOT_HELD
Il chiamante non dispone di privilegi sufficienti.

Commenti

Le caratteristiche risultanti del thread che esegue le attività riflettono l'attività con la priorità più alta.

Al termine dell'attività, chiamare la funzione AvRevertMmThreadCharacteristics .

Nota

L'intestazione avrt.h definisce AvSetMmMaxThreadCharacteristics come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione avrt.h
Libreria Avrt.lib
DLL Avrt.dll

Vedi anche

Servizio Utilità di pianificazione classi multimediali