RtlGetEnabledExtendedFeatures-Funktion (ntddk.h)
Die RtlGetEnabledExtendedFeatures-Routine gibt eine Maske erweiterter Prozessorfeatures zurück, die vom System aktiviert werden.
Syntax
NTSYSAPI ULONG64 RtlGetEnabledExtendedFeatures(
[in] ULONG64 FeatureMask
);
Parameter
[in] FeatureMask
Eine 64-Bit-Featuremaske. Dieser Parameter gibt eine Reihe erweiterter Prozessorfeatures an, für die der Aufrufer Informationen darüber anfordert, ob die Features aktiviert sind. Wenn ein Maskenbit eins ist, fordert der Aufrufer Informationen über das Feature an, das diesem Maskenbit entspricht. Der Aufrufer legt alle anderen Maskenbits auf Null fest. Legen Sie diesen Parameter auf (ULONG64)(-1) fest, um die Maske aller aktivierten Features abzurufen. Um zu bestimmen, ob ein bestimmter Satz von Features aktiviert ist, legen Sie diesen Parameter auf den bitweisen OR eines oder mehrerer XSTATE_MASK_XXX Flagbits fest.
Rückgabewert
RtlGetEnabledExtendedFeatures gibt eine 64-Bit-Maske mit aktivierten erweiterten Prozessorfeatures zurück. Die Routine berechnet diese Maske als Schnittmenge (bitweise AND) zwischen allen aktivierten Features und dem Wert des FeatureMask-Parameters . Weitere Informationen zu den Features, die durch diesen Rückgabewert angegeben werden, finden Sie unter XSTATE_MASK_XXX.
RtlGetEnabledExtendedFeatures gibt 0 zurück, wenn die XSAVE- und XRSTOR-Anweisungen vom System deaktiviert sind. Dies geschieht auch dann, wenn das System XSTATE_MASK_LEGACY_FLOATING_POINT- und XSTATE_MASK_LEGACY_SSE-Features unterstützt. Verwenden Sie ExIsProcessorFeaturePresent oder CPUID, um die Verfügbarkeit von x87-, MMX- und SSE-Prozessorfeatures auf x86- oder x64-Systemen zu ermitteln.
Hinweise
Eine weitere Routine, ExIsProcessorFeaturePresent, gibt an, ob ein erweitertes Prozessorfeature verfügbar ist. Im Gegensatz zu RtlGetEnabledExtendedFeatures gibt es jedoch nicht an, ob das Betriebssystem die Funktion für die Verwendung durch Kernelmodustreiber aktiviert hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 7 und höheren Versionen des Windows-Betriebssystems. |
| Zielplattform | Universell |
| Header | ntddk.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | Ntdll.lib (Benutzermodus); NtosKrnl.lib (Kernelmodus); OneCoreUAP.lib auf Windows 10 |
| DLL | NtDll.dll (Benutzermodus); NtosKrnl.exe (Kernelmodus) |
| IRQL | PASSIVE_LEVEL |