WdfDevStateIsNP-Funktion (wdfdevice.h)

[Gilt für KMDF und UMDF]

Die WdfDevStateIsNP--Methode gibt einen booleschen Wert zurück, der angibt, ob ein angegebener Strom- oder Energierichtlinienstatus ein nicht ausserseitigen Zustand ist.

Syntax

BOOLEAN WdfDevStateIsNP(
  [in] ULONG State
);

Die Parameter

[in] State

Ein WDF_DEVICE_POWER_STATE-typed-Enumerator oder ein WDF_DEVICE_POWER_POLICY_STATE-typed-Enumerator.

Rückgabewert

Wenn der aufrufende Treiber zurzeit nicht auspagebar ist, gibt die WdfDevStateIsNP--Methode TRUEzurück. Andernfalls gibt die Methode FALSE-zurück.

Bemerkungen

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 innerhalb einer Power Policy Callback-Funktion aufrufen. Nachdem der Treiber WdfDeviceGetDevicePowerState oder WdfDeviceGetDevicePowerPolicyStateaufgerufen wurde, kann er WdfDevStateIsNP- aufrufen, um festzustellen, ob der zurückgegebene Zustand einen seitenfähigen oder nicht seitenfähigen Zustand darstellt. Wenn sich der Zustandscomputer des Frameworks in einem nicht auslagerungsfähigen 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 seitenseitigen Pool.

Beispiele

Im folgenden Codebeispiel wird der nicht seitenfähige Wert auf TRUE- festgelegt, wenn sich der Energiezustandscomputer des Frameworks derzeit in einem nicht ausspagebaren Zustand befindet.

BOOLEAN nonpageable;

nonpageable = WdfDevStateIsNP(WdfDeviceGetDevicePowerState(device));

Anforderungen

Siehe auch

WdfDeviceInitSetPowerNotPageable

WdfDeviceInitSetPowerPageable