EVT_WDF_DEVICE_QUERY_STOP Rückruffunktion (wdfdevice.h)

  • Artikel

[Gilt für KMDF und UMDF]

Die EvtDeviceQueryStop-Ereignisrückruffunktion eines Treibers bestimmt, ob ein angegebenes Gerät angehalten werden kann, damit der PnP-Manager Systemhardwareressourcen verteilen kann.

Syntax

EVT_WDF_DEVICE_QUERY_STOP EvtWdfDeviceQueryStop;

NTSTATUS EvtWdfDeviceQueryStop(
  [in] WDFDEVICE Device
)
{...}

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

Rückgabewert

Wenn der Treiber feststellt, dass das Gerät angehalten werden kann, muss die Rückruffunktion EvtDeviceQueryStop STATUS_SUCCESS oder einen anderen status-Wert zurückgeben, für den NT_SUCCESS(status) gleich TRUE ist. Andernfalls muss ein status Wert zurückgegeben werden, für den NT_SUCCESS(status) gleich FALSE ist. Geben Sie STATUS_NOT_SUPPORTED nicht zurück.

Hinweise

Um eine EvtDeviceQueryStop-Rückruffunktion zu registrieren, muss ein Treiber WdfDeviceInitSetPnpPowerEventCallbacks aufrufen.

Wenn das Gerät und der Treiber das Herunterfahren im Leerlauf unterstützen, befindet sich das Gerät möglicherweise nicht im Betriebszustand, wenn das Framework die Rückruffunktion EvtDeviceQueryStop des Treibers aufruft. Die Rückruffunktion kann WdfDeviceStopIdle aufrufen, um das Gerät in seinen Arbeitszustand (D0) zu erzwingen, und dann kann die Rückruffunktion WdfDeviceResumeIdle aufrufen, bevor es zurückgegeben wird.

Weitere Informationen zur Rückruffunktion EvtDeviceQueryStop finden Sie unter Behandeln von Anforderungen zum Beenden eines Geräts.

Das Framework synchronisiert die Rückruffunktion EvtDeviceQueryStop nicht mit anderen PnP- und Energieverwaltungsrückruffunktionen. Informationen dazu, wie das Framework die Ausführung der Ereignisrückruffunktionen eines Treibers synchronisiert, finden Sie unter Verwenden der automatischen Synchronisierung.

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfdevice.h (einschließen von Wdf.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

EvtDeviceQueryRemove