Compartilhar via


Função SetXStateFeaturesMask (winbase.h)

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

Sintaxe

BOOL SetXStateFeaturesMask(
  [in, out] PCONTEXT Context,
  [in]      DWORD64  FeatureMask
);

Parâmetros

[in, out] Context

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

[in] FeatureMask

Uma máscara de recursos XState a serem definidos na estrutura CONTEXT especificada.

Retornar valor

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

Comentários

A função SetXStateFeaturesMask define a máscara de recursos válidos no contexto especificado. Antes de chamar GetThreadContext, Wow64GetThreadContext, SetThreadContext ou Wow64SetThreadContext , o aplicativo deve chamar SetXStateFeaturesMask para especificar qual conjunto de recursos recuperar ou definir. O sistema ignora silenciosamente qualquer recurso especificado no FeatureMask que não está habilitado no processador.

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 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbase.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

CONTEXTO

GetThreadContext

Intel AVX

SetThreadContext

Como trabalhar com o contexto XState

Wow64GetThreadContext

Wow64SetThreadContext