Função GetProcessDefaultCpuSetMasks (processthreadsapi.h)

Recupera a lista de Conjuntos de CPU no conjunto padrão do processo que foi definido por SetProcessDefaultCpuSetMasks ou SetProcessDefaultCpuSets.

Sintaxe

BOOL GetProcessDefaultCpuSetMasks(
  HANDLE          Process,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount,
  PUSHORT         RequiredMaskCount
);

Parâmetros

Process

Especifica um identificador de processo para o processo a ser consultado. Esse identificador deve ter o direito de acesso PROCESS_QUERY_LIMITED_INFORMATION . O valor retornado por GetCurrentProcess também pode ser especificado aqui.

CpuSetMasks

Especifica um buffer opcional para recuperar uma lista de estruturas de GROUP_AFFINITY que representam os conjuntos de CPU padrão do processo.

CpuSetMaskCount

Especifica o tamanho da matriz CpuSetMasks , em elementos .

RequiredMaskCount

No retorno bem-sucedido, especifica o número de estruturas de afinidade gravadas na matriz. Se a matriz CpuSetMasks for muito pequena, a função falhará com ERROR_INSUFFICIENT_BUFFER e definirá o parâmetro RequiredMaskCount como o número de elementos necessários. O número de elementos necessários é sempre menor ou igual à contagem máxima de grupos retornada por GetMaximumProcessorGroupCount.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero e as informações de erro estendidas poderão ser recuperadas chamando GetLastError.

Se a matriz fornecida for muito pequena, o valor de erro será ERROR_INSUFFICIENT_BUFFER e RequiredMaskCount será definido como o número de elementos necessários.

Comentários

Se nenhum conjunto de CPU padrão for definido para um determinado processo, o parâmetro RequiredMaskCount será definido como 0 e a função terá êxito.

Essa função é análoga a GetProcessDefaultCpuSets, exceto que ela usa afinidades de grupo em vez de IDs de conjunto de CPU para representar uma lista de conjuntos de CPU. Isso significa que os conjuntos de CPU padrão do processo são mapeados para seus processadores domésticos e esses processadores são recuperados na lista resultante de afinidades de grupo.

Requisitos