Função GetSystemCpuSetInformation (processthreadsapi.h)

Permite que um aplicativo consulte os Conjuntos de CPU disponíveis no sistema e seu estado atual.

Sintaxe

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

Parâmetros

Information

Um ponteiro para uma estrutura SYSTEM_CPU_SET_INFORMATION que recebe os dados do Conjunto de CPU. Passe NULL com um comprimento de buffer de 0 para determinar o tamanho do buffer necessário.

BufferLength

O comprimento, em bytes, do buffer de saída passado como o argumento Information.

ReturnedLength

O comprimento, em bytes, dos dados válidos no buffer de saída se o buffer for grande o suficiente ou o tamanho necessário do buffer de saída. Se nenhum conjunto de CPU existir, esse valor será 0.

Process

Um identificador opcional para um processo. Esse processo é usado para determinar o valor do sinalizador AllocatedToTargetProcess na estrutura SYSTEM_CPU_SET_INFORMATION. Se um conjunto de CPU for alocado para o processo especificado, o sinalizador será definido. Caso contrário, fica claro. Esse identificador deve ter o direito de acesso PROCESS_QUERY_LIMITED_INFORMATION. O valor retornado por GetCurrentProcess também pode ser especificado aqui.

Flags

Reservado, precisa ser 0.

Retornar valor

Se a API for bem-sucedida, ela retornará TRUE. Se falhar, o motivo do erro estará disponível por meio de GetLastError. Se o buffer de informações for NULL ou não for grande o suficiente, o código de erro ERROR_INSUFFICIENT_BUFFER será retornado. Essa API não pode falhar quando são passados parâmetros válidos e um buffer grande o suficiente para manter todos os dados de retorno.

Requisitos