WdfDeviceIndicateWakeStatus-Funktion (wdfdevice.h)

Artikel
02/07/2025

[Gilt nur für KMDF]

Die WdfDeviceIndicateWakeStatus Methode informiert das Framework darüber, dass der aufrufende Bustreiber nicht mehr auf ein angegebenes Gerät wartet, um ein Wakesignal auf dem Bus auszulösen.

Syntax

NTSTATUS WdfDeviceIndicateWakeStatus(
  [in] WDFDEVICE Device,
  [in] NTSTATUS  WaitWakeStatus
);

Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

[in] WaitWakeStatus

Ein NTSTATUS-Statuswert. Wenn das Gerät ein Wake-Signal ausgelöst hat, muss der Aufrufer diesen Wert auf STATUS_SUCCESS oder einen anderen Statuswert festlegen, für den NT_SUCCESS(WaitWakeStatus) TRUEist. Wenn das Gerät kein Wakesignal ausgelöst hat oder ein Fehler erkannt wurde, muss der Anrufer einen Statuswert angeben, für den NT_SUCCESS(WaitWakeStatus) FALSEentspricht. 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 eingerichtet, um zu warten, bis das Gerät ein Wakesignal auslöst.
STATUS_INVALID_DEVICE_STATE	Der Anruftreiber ist nicht dafür verantwortlich, auf das Gerät zu warten, um ein Wake-Signal auszulösen.

Die Methode gibt möglicherweise andere NTSTATUS-Wertezurück.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

Wenn NT_SUCCESS(WaitWakeStatus) TRUEist, stellt das Framework das Gerät und das System in ihren Arbeitszuständen wieder her. Wenn NT_SUCCESS(WaitWakeStatus) gleich FALSE-ist, verbleibt das Gerät und das System in ihrem aktuellen Zustand.

Weitere Informationen zum Aufrufen der WdfDeviceIndicateWakeStatus--Methode finden Sie unter Unterstützende System Wake-Up-.

Beispiele

Im folgenden Codebeispiel wird das Framework darüber informiert, dass das angegebene Gerät ein Wake-Signal ausgelöst hat.

NTSTATUS  status;

status = WdfDeviceIndicateWakeStatus(
                                     hChild,
                                     STATUS_SUCCESS
                                     );

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
Header-	wdfdevice.h (einschließen Wdf.h)
Library	Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL-	<= DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Freigeben über