Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Retorna a máscara de recursos XState definida dentro de uma estrutura CONTEXT .
Sintaxe
BOOL GetXStateFeaturesMask(
[in] PCONTEXT Context,
[out] PDWORD64 FeatureMask
);
Parameters
[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.
Valor de devolução
Essa função retornará TRUE se tiver êxito, caso contrário, FALSE.
Observações
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á nenhum 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 de chamadas para GetProcAddress. Consulte Como trabalhar com o contexto XState para obter detalhes.
Requirements
| Requirement | Valor |
|---|---|
| Cliente mínimo suportado | Windows 7 com SP1 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo compatível | Windows Server 2008 R2 com SP1 [aplicativos da área de trabalho | Aplicativos UWP] |
| da Plataforma de Destino | Windows |
| Cabeçalho | winbase.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| de DLL | Kernel32.dll |