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 |