EVT_WDF_DEVICE_QUERY_STOP Rückruffunktion (wdfdevice.h)
[Gilt für KMDF und UMDF]
Die EvtDeviceQueryStop Ereignisrückruffunktion eines Treibers bestimmt, ob ein angegebenes Gerät beendet werden kann, damit der PnP-Manager Systemhardwareressourcen neu verteilen kann.
Syntax
EVT_WDF_DEVICE_QUERY_STOP EvtWdfDeviceQueryStop;
NTSTATUS EvtWdfDeviceQueryStop(
[in] WDFDEVICE Device
)
{...}
Parameter
[in] Device
Ein Handle zu einem Framework-Geräteobjekt.
Rückgabewert
Wenn der Treiber feststellt, dass das Gerät beendet werden kann, muss die EvtDeviceQueryStop- Rückruffunktion STATUS_SUCCESS oder einen anderen Statuswert zurückgeben, für den NT_SUCCESS(Status) TRUEentspricht. Andernfalls muss ein Statuswert zurückgegeben werden, für den NT_SUCCESS(Status) FALSE-entspricht. Geben Sie STATUS_NOT_SUPPORTED nicht zurück.
Bemerkungen
Um eine EvtDeviceQueryStop- Rückruffunktion zu registrieren, muss ein Treiber WdfDeviceInitSetPnpPowerEventCallbacksaufrufen.
Wenn das Gerät und der Treiber den Leerlauf unterstützen, befindet sich das Gerät möglicherweise nicht im Arbeitszustand, wenn das Framework die EvtDeviceQueryStop Rückruffunktion des Treibers aufruft. Die Rückruffunktion kann WdfDeviceStopIdle- aufrufen, um zu erzwingen, dass das Gerät in den Arbeitszustand (D0) wechselt, und dann kann die Rückruffunktion WdfDeviceResumeIdle- aufrufen, bevor sie zurückgegeben wird.
Weitere Informationen zur EvtDeviceQueryStop- Rückruffunktion finden Sie unter Behandeln von Anforderungen zum Beenden eines Geräts.
Das Framework synchronisiert nicht die EvtDeviceQueryStop Rückruffunktion 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- | Universal |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Header- | wdfdevice.h (einschließen Wdf.h) |
| IRQL- | PASSIVE_LEVEL |