Compartilhar via


Função RtlGetEnabledExtendedFeatures (ntddk.h)

A rotina RtlGetEnabledExtendedFeatures retorna uma máscara de recursos de processador estendidos habilitados pelo sistema.

Sintaxe

NTSYSAPI ULONG64 RtlGetEnabledExtendedFeatures(
  [in] ULONG64 FeatureMask
);

Parâmetros

[in] FeatureMask

Uma máscara de recursos de 64 bits. Esse parâmetro indica um conjunto de recursos de processador estendidos para os quais o chamador solicita informações sobre se os recursos estão habilitados. Se um bit de máscara for um, o chamador solicitará informações sobre o recurso que corresponde a esse bit de máscara. O chamador define todos os outros bits de máscara como zero. Defina esse parâmetro como (ULONG64)(-1) para obter a máscara de todos os recursos habilitados. Para determinar se um determinado conjunto de recursos está habilitado, defina esse parâmetro como OR bit a bit de um ou mais bits de sinalizador XSTATE_MASK_XXX .

Retornar valor

RtlGetEnabledExtendedFeatures retorna uma máscara de 64 bits de recursos de processador estendido habilitados. A rotina calcula essa máscara como a interseção (AND bit a bit) entre todos os recursos habilitados e o valor do parâmetro FeatureMask . Para obter mais informações sobre os recursos indicados por esse valor retornado, consulte XSTATE_MASK_XXX.

RtlGetEnabledExtendedFeatures retornará 0 se as instruções XSAVE e XRSTOR forem desabilitadas pelo sistema. Isso acontece mesmo que o sistema dê suporte a recursos de XSTATE_MASK_LEGACY_FLOATING_POINT e XSTATE_MASK_LEGACY_SSE. Use ExIsProcessorFeaturePresent ou CPUID para determinar a disponibilidade de recursos de processador x87, MMX e SSE em sistemas x86 ou x64.

Comentários

Outra rotina, ExIsProcessorFeaturePresent, indica se um recurso de processador estendido está disponível. Ao contrário de RtlGetEnabledExtendedFeatures, no entanto, ele não indica se o sistema operacional habilitou o recurso para uso por drivers no modo kernel.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 7 e versões posteriores do sistema operacional Windows.
Plataforma de Destino Universal
Cabeçalho ntddk.h (inclua Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca Ntdll.lib (modo de usuário); NtosKrnl.lib (modo kernel); OneCoreUAP.lib no Windows 10
DLL NtDll.dll (modo de usuário); NtosKrnl.exe (modo kernel)
IRQL PASSIVE_LEVEL

Confira também

ExIsProcessorFeaturePresent