Funzione KsFilterRegisterPowerCallbacks (ks.h)
La funzione KsFilterRegisterPowerCallbacks registra i callback di risparmio energia per Filter.
Sintassi
void KsFilterRegisterPowerCallbacks(
[in] PKSFILTER Filter,
[in, optional] PFNKSFILTERPOWER Sleep,
[in, optional] PFNKSFILTERPOWER Wake
);
Parametri
[in] Filter
Puntatore alla struttura KSFILTER per cui registrare i callback di alimentazione. Per ricevere messaggi di notifica alimentazione, il filtro deve essere incentrato sui filtri.
[in, optional] Sleep
Puntatore a una funzione che gestisce le richieste di sospensione per il dispositivo. Se NULL, non viene registrato alcun callback in sospensione. Per altre informazioni, vedere la sezione Osservazioni di seguito.
[in, optional] Wake
Puntatore a una funzione che gestisce le richieste di riattivazione per il dispositivo. Se NULL, non viene specificato alcun callback di riattivazione. Per altre informazioni, vedere la sezione Osservazioni di seguito.
Valore restituito
nessuno
Osservazioni
Avviso
Non tentare di ottenere il mutex del controllo filtro* dall'interno del callback di sospensione o riattivazione oppure potrebbe verificarsi un deadlock. Per altre informazioni sui mutex, vedere Mutexes in AVStream.
I due callback devono essere prototipi come indicato di seguito:
void Sleep/Wake (IN PKSFILTER Filter, IN DEVICE_POWER_STATE State);
Il callback sospensione viene eseguito se Filter è un filtro incentrato sui filtri e il dispositivo sta per essere in sospensione. Il callback di riattivazione viene eseguito se Filter è un filtro incentrato sui filtri e il dispositivo viene riattivato.
Per informazioni sugli stati di alimentazione dei dispositivi, vedere Stati di alimentazione del dispositivo.
Vedere anche Inizializzazione di un minidriver AVStream e elaborazione basata sui filtri.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Disponibile nei sistemi operativi Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX. |
Piattaforma di destinazione | Universale |
Intestazione | ks.h (include Ks.h) |
Libreria | Ks.lib |
IRQL | PASSIVE_LEVEL |