RtlGetEnabledExtendedFeatures-Funktion (ntddk.h)
Die RtlGetEnabledExtendedFeatures Routine gibt eine Maske erweiterter Prozessorfeatures zurück, die vom System aktiviert sind.
Syntax
NTSYSAPI ULONG64 RtlGetEnabledExtendedFeatures(
[in] ULONG64 FeatureMask
);
Parameter
[in] FeatureMask
Eine 64-Bit-Featuremaske. Dieser Parameter gibt einen Satz 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 festzustellen, ob ein bestimmter Satz von Features aktiviert ist, legen Sie diesen Parameter auf den bitweisen OR einer oder mehrerer XSTATE_MASK_XXX Flagbits fest.
Rückgabewert
RtlGetEnabledExtendedFeatures gibt eine 64-Bitmaske der aktivierten erweiterten Prozessorfunktionen zurück. Die Routine berechnet diese Maske als Schnittmenge (bitweise UND) zwischen allen aktivierten Features und dem Wert des FeatureMask Parameter. 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 werden. 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-Prozessorfunktionen auf x86- oder x64-Systemen zu ermitteln.
Bemerkungen
Eine weitere Routine, ExIsProcessorFeaturePresent, gibt an, ob ein erweitertes Prozessorfeature verfügbar ist. Im Gegensatz zu RtlGetEnabledExtendedFeaturesgibt es jedoch nicht an, ob das Betriebssystem das Feature für die Verwendung durch Kernelmodustreiber aktiviert hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen des Windows-Betriebssystems. |
| Zielplattform- | Universal |
| Header- | ntddk.h (enthalten Wdm.h, Ntddk.h, Ntifs.h) |
| Library | Ntdll.lib (Benutzermodus); NtosKrnl.lib (Kernelmodus); OneCoreUAP.lib unter Windows 10 |
| DLL- | NtDll.dll (Benutzermodus); NtosKrnl.exe (Kernelmodus) |
| IRQL- | PASSIVE_LEVEL |