WdfDeviceIndicateWakeStatus-Funktion (wdfdevice.h)
[Gilt nur für KMDF]
Die WdfDeviceIndicateWakeStatus-Methode informiert das Framework darüber, dass der aufrufende Bustreiber nicht mehr darauf wartet, dass ein angegebenes Gerät ein Aktivierungssignal auf dem Bus auslöst.
Syntax
NTSTATUS WdfDeviceIndicateWakeStatus(
[in] WDFDEVICE Device,
[in] NTSTATUS WaitWakeStatus
);
Parameter
[in] Device
Ein Handle für ein Framework-Geräteobjekt.
[in] WaitWakeStatus
Ein NTSTATUS-status-Wert. Wenn das Gerät ein Aktivierungssignal ausgelöst hat, muss der Aufrufer diesen Wert auf STATUS_SUCCESS oder einen anderen status Wert festlegen, für den NT_SUCCESS(WaitWakeStatus) gleich TRUE ist. Wenn das Gerät kein Aktivierungssignal ausgelöst hat oder ein Fehler erkannt wurde, muss der Aufrufer einen status-Wert angeben, für den NT_SUCCESS(WaitWakeStatus) false ist. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt WdfDeviceIndicateWakeStatus STATUS_SUCCESS zurück. Weitere Rückgabewerte sind:
Rückgabecode | Beschreibung |
---|---|
|
WaitWakeStatus ist STATUS_PENDING oder STATUS_CANCELLED. |
|
Der Treiberstapel wurde nicht so eingerichtet, dass er darauf wartet, dass das Gerät ein Aktivierungssignal auslöst. |
|
Der aufrufende Treiber ist nicht dafür verantwortlich, darauf zu warten, dass das Gerät ein Aktivierungssignal auslöst. |
Die -Methode gibt möglicherweise andere NTSTATUS-Werte zurück.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Wenn NT_SUCCESS(WaitWakeStatus) gleich TRUE ist, stellt das Framework das Gerät und das System wieder in ihren Arbeitszustand zurück. Wenn NT_SUCCESS(WaitWakeStatus) gleich FALSE ist, verbleiben das Gerät und das System in ihrem aktuellen Zustand.
Weitere Informationen zum Aufrufen der WdfDeviceIndicateWakeStatus-Methode finden Sie unter Unterstützung der Systemreaktivierung.
Beispiele
Im folgenden Codebeispiel wird das Framework darüber informiert, dass das angegebene Gerät ein Aktivierungssignal ausgelöst hat.
NTSTATUS status;
status = WdfDeviceIndicateWakeStatus(
hChild,
STATUS_SUCCESS
);
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Universell |
KMDF-Mindestversion | 1.0 |
Kopfzeile | wdfdevice.h (einschließen von Wdf.h) |
Bibliothek | Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).) |
IRQL | <= DISPATCH_LEVEL |
DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |