Funzione AvSetMmThreadCharacteristicsA (avrt.h)

Articolo
08/22/2023

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

Condividi tramite