Funzione AvSetMmThreadCharacteristicsA (avrt.h)

Articolo
11/20/2024

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 alla prima chiamata o non è riconosciuto (nelle chiamate successive).
ERROR_INVALID_TASK_NAME	L'attività specificata non corrisponde ad alcuna delle attività archiviate nel Registro di sistema.
ERROR_PRIVILEGE_NOT_HELD	Il chiamante non dispone di privilegi sufficienti.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	avrt.h
libreria	Avrt.lib
dll	Avrt.dll

Vedere anche

servizio utilità di pianificazione classi multimediali

Condividi tramite