Funzione GetSystemCpuSetInformation

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

Sintassi

BOOL WINAPI GetSystemCpuSetInformation(
  _Out_opt_  PSYSTEM_CPU_SET_INFORMATION  Information,
  _In_       ULONG                        BufferLength,
  _Out_      PULONG                       ReturnedLength,
  _In_opt_   HANDLE                       Process,
  _Reserved_ ULONG                        Flags
);

Parametri

Informazioni [out, facoltativo]

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 [in]

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

RestituitoLength [out]

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

Processo [in, facoltativo]

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.

Flag

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 information era NULL o non abbastanza grande, viene restituito il codice di errore ERROR_INSUFFICIENT_BUFFER. Questa API non può non riuscire quando sono stati passati parametri validi e un buffer sufficientemente grande per contenere tutti i dati restituiti.

Requisiti