Compartilhar via


Função EnableProcessOptionalXStateFeatures (winbase.h)

Essa função habilita um conjunto de recursos opcionais do XState para o processo atual.

Sintaxe

BOOL EnableProcessOptionalXStateFeatures(
  DWORD64 Features
);

Parâmetros

Features

Uma máscara de bits na qual cada bit representa um recurso XState opcional para habilitar para o processo atual.

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. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Em geral, os recursos opcionais do XState são desabilitados por padrão para threads recém-criados e habilitados sob demanda posteriormente. Quando essa função retornar, os recursos XState opcionais especificados serão habilitados para todos os threads existentes no processo atual, e todos os threads futuros criados no processo terão os recursos XState opcionais especificados habilitados no momento da criação do thread.

Somente bits de recurso XState compatíveis com o sistema têm permissão para serem fornecidos a essa função; caso contrário, um erro é retornado. Os bits de recurso XState compatíveis com o sistema podem ser obtidos por meio da rotina GetEnabledXStateFeatures . Se bits de recurso XState não opcionais compatíveis com o sistema forem fornecidos (por exemplo, AVX, AVX2 etc. são recursos XState não opcionais), eles são ignorados e não farão com que essa função retorne um erro. Observe que todos os recursos XState não opcionais compatíveis com o sistema são sempre habilitados para cada thread por padrão.

Requisitos

   
Cliente mínimo com suporte Windows 11
Servidor mínimo com suporte Windows Server 2022
Cabeçalho winbase.h

Confira também

GetEnabledXStateFeatures

GetThreadEnabledXStateFeatures