KsFilterRegisterPowerCallbacks-Funktion (ks.h)
Die Funktion KsFilterRegisterPowerCallbacks registriert Energieverwaltungsrückrufe für Filter.
Syntax
void KsFilterRegisterPowerCallbacks(
[in] PKSFILTER Filter,
[in, optional] PFNKSFILTERPOWER Sleep,
[in, optional] PFNKSFILTERPOWER Wake
);
Parameter
[in] Filter
Ein Zeiger auf die KSFILTER-Struktur , für die Energierückrufe registriert werden sollen. Um Energiebenachrichtigungen empfangen zu können, muss Filter filterzentriert sein.
[in, optional] Sleep
Ein Zeiger auf eine Funktion, die Standbyanforderungen für das Gerät verarbeitet. Bei NULL wird kein Standbyrückruf registriert. Weitere Informationen finden Sie weiter unten im Abschnitt Hinweise.
[in, optional] Wake
Ein Zeiger auf eine Funktion, die Reaktivierungsanforderungen für das Gerät verarbeitet. Bei NULL wird kein Reaktivierungsrückruf angegeben. Weitere Informationen finden Sie weiter unten im Abschnitt Hinweise.
Rückgabewert
Keine
Bemerkungen
Warnung
Versuchen Sie nicht, das Mutex des Filtersteuerelements* aus dem Standby- oder Wake-Rückruf abzurufen, oder es kann ein Deadlock auftreten. Weitere Informationen zu Mutexes finden Sie unter Mutexes in AVStream.
Die beiden Rückrufe sollten wie folgt prototypisiert werden:
void Sleep/Wake (IN PKSFILTER Filter, IN DEVICE_POWER_STATE State);
Der Standby-Rückruf erfolgt, wenn Filter ein filterorientierter Filter ist und das Gerät in den Ruhemodus wechselt. Der Reaktivierungsrückruf wird durchgeführt, wenn Filter ein filterorientierter Filter ist und das Gerät aktiviert wird.
Informationen zu Geräteleistungszuständen finden Sie unter Gerätestromzustände.
Weitere Informationen finden Sie unter Initializing an AVStream Minidriver and Filter-Centric Processing.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher DirectX-Versionen. |
| Zielplattform | Universell |
| Header | ks.h (einschließlich Ks.h) |
| Bibliothek | Ks.lib |
| IRQL | PASSIVE_LEVEL |