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 de retorno

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

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Observações

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 opcionais do XState especificados serão habilitados para todos os threads existentes no processo atual, e todos os threads futuros criados no processo terão os recursos opcionais do XState especificados habilitados no momento da criação do thread.

Somente os bits de recurso XState compatíveis com o sistema têm permissão para serem fornecidos para essa função, caso contrário, um erro será 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.

Requirements

Requirement Value
Cliente mínimo suportado Windows 11
Servidor mínimo compatível Windows Server 2022
Header winbase.h
Library kernel32. Lib

Consulte também

GetEnabledXStateFeatures

GetThreadEnabledXStateFeatures