WdfDeviceIndicateWakeStatus-Funktion (wdfdevice.h)

  • Artikel

[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
STATUS_INVALID_PARAMETER
 WaitWakeStatus ist STATUS_PENDING oder STATUS_CANCELLED.
STATUS_INVALID_DEVICE_REQUEST
 Der Treiberstapel wurde nicht so eingerichtet, dass er darauf wartet, dass das Gerät ein Aktivierungssignal auslöst.
STATUS_INVALID_DEVICE_STATE
 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)