Condividi tramite


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

Vedi anche

KsPinRegisterPowerCallbacks