WdfDevStateIsNP-Funktion (wdfdevice.h)
[Gilt für KMDF und UMDF]
Die WdfDevStateIsNP-Methode gibt einen booleschen Wert zurück, der angibt, ob ein angegebener Energiezustand oder Energierichtlinienzustand ein nicht aussetzbarer Zustand ist.
Syntax
BOOLEAN WdfDevStateIsNP(
[in] ULONG State
);
Parameter
[in] State
Ein WDF_DEVICE_POWER_STATE typisierter Enumerator oder ein WDF_DEVICE_POWER_POLICY_STATE typisierter Enumerator.
Rückgabewert
Wenn der aufrufende Treiber derzeit nicht auslagerbar ist, gibt die WdfDevStateIsNP-MethodeTRUE zurück. Andernfalls gibt die Methode FALSE zurück.
Hinweise
Um den aktuellen Zustand des Energiezustandscomputers des Frameworks abzurufen, kann ein Treiber WdfDeviceGetDevicePowerState aus einer PnP- oder Power-Rückruffunktion aufrufen. Um den aktuellen Zustand des Energierichtlinienzustandscomputers des Frameworks abzurufen, kann ein Treiber WdfDeviceGetDevicePowerPolicyState aus einer Power Policy-Rückruffunktion aufrufen. Nachdem der Treiber WdfDeviceGetDevicePowerState oder WdfDeviceGetDevicePowerPolicyState aufgerufen hat, kann er WdfDevStateIsNP aufrufen, um zu bestimmen, ob der zurückgegebene Zustand einen auslagerungsfähigen oder nicht ausgelagerten Zustand darstellt. Wenn sich der Zustandscomputer des Frameworks in einem nicht ausgelagerten Zustand befindet, kann der Treiber nicht ausgelagert werden und darf keine Vorgänge ausführen, die dazu führen können, dass das Betriebssystem auf die Auslagerungsdatei zugreift. Solche Vorgänge umfassen den Zugriff auf Dateien, die Registrierung oder den ausgelagerten Pool.
Beispiele
Im folgenden Codebeispiel wird der nicht ausstellbare Wert auf TRUE festgelegt, wenn sich der Energiezustandscomputer des Frameworks derzeit in einem nicht ausstellbaren Zustand befindet.
BOOLEAN nonpageable;
nonpageable = WdfDevStateIsNP(WdfDeviceGetDevicePowerState(device));
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfdevice.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | Beliebige Ebene |