Função GetXStateFeaturesMask (winbase.h)

Artigo
08/27/2023

Retorna a máscara de recursos XState definida em uma estrutura CONTEXT.

Sintaxe

BOOL GetXStateFeaturesMask(
  [in]  PCONTEXT Context,
  [out] PDWORD64 FeatureMask
);

Parâmetros

[in] Context

Um ponteiro para uma estrutura CONTEXT que foi inicializada com InitializeContext.

[out] FeatureMask

Um ponteiro para uma variável que recebe a máscara de recursos XState que estão presentes na estrutura CONTEXT especificada.

Retornar valor

Essa função retornará TRUE se tiver êxito, caso contrário, FALSE.

Comentários

A função GetXStateFeaturesMask retorna a máscara de recursos válidos no contexto especificado. Se um CONTEXT for passado para GetThreadContext ou Wow64GetThreadContext, o aplicativo deverá chamar SetXStateFeaturesMask para definir quais recursos devem ser recuperados. GetXStateFeaturesMask deve ser chamado no CONTEXT retornado por GetThreadContext ou Wow64GetThreadContext para determinar quais áreas de recursos contêm dados válidos. Se um bit de recurso específico não estiver definido, o estado correspondente estará em um estado INITIALIZED específico do processador e o conteúdo da área de recurso recuperada por LocateXStateFeature será indefinido.

A definição de recursos XState é específica do fornecedor do processador. Consulte os manuais de referência do processador relevantes para obter informações adicionais sobre um recurso específico.

Nota O valor retornado por GetXStateFeaturesMask em um CONTEXT após uma operação de contexto sempre será um subconjunto da máscara especificada em uma chamada para SetXStateFeaturesMask antes da operação de contexto.

Windows 7 com SP1 e Windows Server 2008 R2 com SP1: A API AVX é implementada pela primeira vez no Windows 7 com SP1 e Windows Server 2008 R2 com SP1 . Como não há SDK para SP1, isso significa que não há cabeçalhos e arquivos de biblioteca disponíveis para trabalhar. Nessa situação, um chamador deve declarar as funções necessárias desta documentação e obter ponteiros para elas usando GetModuleHandle em "Kernel32.dll", seguido por chamadas para GetProcAddress. Consulte Trabalhando com o contexto XState para obter detalhes.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 com SP1 [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2 com SP1 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	winbase.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll