PFNKSDEVICEQUERYPOWER-Rückruffunktion (ks.h)

AVStream ruft die AVStrMiniDeviceQueryPower-Routine eines Minitreibers auf, wenn eine IRP_MN_QUERY_POWER-Anforderung empfangen wird.

Syntax

PFNKSDEVICEQUERYPOWER Pfnksdevicequerypower;

NTSTATUS Pfnksdevicequerypower(
  [in] PKSDEVICE Device,
  [in] PIRP Irp,
  [in] DEVICE_POWER_STATE DeviceTo,
  [in] DEVICE_POWER_STATE DeviceFrom,
  [in] SYSTEM_POWER_STATE SystemTo,
  [in] SYSTEM_POWER_STATE SystemFrom,
  [in] POWER_ACTION Action
)
{...}

Parameter

[in] Device

Zeiger auf die KSDEVICE-Struktur , die die IRP_MN_QUERY_POWER.

[in] Irp

Zeiger auf die vonDevice ausgestellte IRP_MN_QUERY_POWER.

[in] DeviceTo

Der vom Aussteller von Irp angeforderte Energiezustand.

[in] DeviceFrom

Der aktuelle Energiezustand des Geräts.

[in] SystemTo

Der Systemzustand, in den übergehen soll, wird angegeben, wenn ein Systemenergiezustandsübergang abgefragt wird. Dieser Wert ist nicht angegeben, wenn der Aufruf auf eine Abfrage zum Ändern des Gerätezustands zurückzuführen ist.

[in] SystemFrom

Aktueller Systemzustand, der angegeben wird, wenn ein Systemenergiezustandsübergang abgefragt wird. Dieser Wert ist nicht angegeben, wenn der Aufruf auf eine Abfrage zum Ändern des Gerätezustands zurückzuführen ist.

[in] Action

Gibt zusätzliche Informationen zum angeforderten Übergang an. Mögliche Werte sind Enumeratoren des POWER_ACTION Typs.

Rückgabewert

Sollte STATUS_SUCCESS oder den Fehlercode zurückgeben, der vom Versuch zurückgegeben wurde, den Vorgang auszuführen. Durch die Rückgabe STATUS_SUCCESS garantiert der Treiber, dass er keinen Vorgang startet, der seine Fähigkeit zum Festlegen des angeforderten Energiezustands ändern würde. Der Treiber sollte alle IRP in die Warteschlange stellen, die einen solchen Vorgang erfordern, bis eine IRP_MN_SET_POWER abgeschlossen wird, die das Gerät in einen akzeptablen Energiezustand zurückgibt.

Hinweise

Der Energie-Manager oder der Besitzer einer Geräteenergierichtlinie sendet eine IRP_MN_QUERY_POWER-Anforderung , um zu bestimmen, ob der Energiezustand des Systems oder Geräts geändert werden kann (z. B. um in den Energiesparmodus zu wechseln).

Wenn ein Treiber eine IRP_MN_QUERY_POWER Anforderung für einen Systemstromzustand fehlschlägt, antwortet der Energie-Manager in der Regel mit einem IRP_MN_SET_POWER. In der Regel bestätigt dieses IRP den aktuellen Systemzustand. Es ist jedoch möglich, dass Treiber eine IRP_MN_SET_POWER zum abgefragten Zustand oder zu einem anderen Zwischenzustand erhalten. Die Fahrer sollten darauf vorbereitet sein, diese Situationen zu bewältigen.

Der Minidriver gibt die Adresse dieser Routine im QueryPower-Member der KSDEVICE_DISPATCH-Struktur an.

Diese Routine ist optional.

Anforderungen

Weitere Informationen

IRP_MN_QUERY_POWER

KSDEVICE_DISPATCH