Funzione AvSetMmThreadCharacteristicsA (avrt.h)

  • Articolo

Associa il thread chiamante all'attività specificata.

Sintassi

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

Parametri

[in] TaskName

Nome dell'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

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

Nota

L'intestazione avrt.h definisce AvSetMmThreadCharacteristics 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