Funzione GetSystemCpuSetInformation (processthreadsapi.h)

Consente a un'applicazione di eseguire query sui set di CPU disponibili nel sistema e sul relativo stato corrente.

Sintassi

BOOL GetSystemCpuSetInformation(
  PSYSTEM_CPU_SET_INFORMATION Information,
  ULONG                       BufferLength,
  PULONG                      ReturnedLength,
  HANDLE                      Process,
  ULONG                       Flags
);

Parametri

Information

Puntatore a una struttura SYSTEM_CPU_SET_INFORMATION che riceve i dati del set di CPU. Passare NULL con una lunghezza del buffer pari a 0 per determinare le dimensioni del buffer necessarie.

BufferLength

Lunghezza, in byte, del buffer di output passato come argomento Informazioni.

ReturnedLength

Lunghezza, in byte, dei dati validi nel buffer di output se il buffer è sufficientemente grande o le dimensioni necessarie del buffer di output. Se non esistono set di CPU, questo valore sarà 0.

Process

Handle facoltativo per un processo. Questo processo viene usato per determinare il valore del flag AllocateToTargetProcess nella struttura SYSTEM_CPU_SET_INFORMATION. Se un set di CPU viene allocato al processo specificato, il flag viene impostato. In caso contrario, è chiaro. Questo handle deve avere il diritto di accesso PROCESS_QUERY_LIMITED_INFORMATION. Il valore restituito da GetCurrentProcess può essere specificato anche qui.

Flags

Riservato, deve essere 0.

Valore restituito

Se l'API ha esito positivo, restituisce TRUE. Se ha esito negativo, il motivo dell'errore è disponibile tramite GetLastError. Se il buffer delle informazioni è NULL o non è sufficientemente grande, viene restituito il codice di errore ERROR_INSUFFICIENT_BUFFER. Questa API non può avere esito negativo quando sono stati passati parametri validi e un buffer sufficientemente grande da contenere tutti i dati restituiti.

Requisiti