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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen sowie DirectX 8.0 und höher DirectX-Versionen. |
| Zielplattform | Desktop |
| Kopfzeile | ks.h (ks.h einschließen) |