Função GetSystemCpuSetInformation
Permite que um aplicativo consulte os Conjuntos de CPU disponíveis no sistema e seu estado atual.
Sintaxe
BOOL WINAPI GetSystemCpuSetInformation(
_Out_opt_ PSYSTEM_CPU_SET_INFORMATION Information,
_In_ ULONG BufferLength,
_Out_ PULONG ReturnedLength,
_In_opt_ HANDLE Process,
_Reserved_ ULONG Flags
);
Parâmetros
-
Informações [out, opcional]
-
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 [in]
-
O comprimento, em bytes, do buffer de saída passado como o argumento Information.
-
ReturnedLength [out]
-
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.
-
Processo [in, opcional]
-
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.
-
Sinalizadores
-
Reservado, deve ser 0.
Valor retornado
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
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 10 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte |
Windows Server 2016 [aplicativos da área de trabalho | Aplicativos UWP] |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|