Função KsFilterRegisterPowerCallbacks (ks.h)
A função KsFilterRegisterPowerCallbacks registra retornos de chamada de gerenciamento de energia para Filter.
Sintaxe
void KsFilterRegisterPowerCallbacks(
[in] PKSFILTER Filter,
[in, optional] PFNKSFILTERPOWER Sleep,
[in, optional] PFNKSFILTERPOWER Wake
);
Parâmetros
[in] Filter
Um ponteiro para a estrutura KSFILTER para a qual registrar retornos de chamada de energia. Para receber mensagens de notificação de energia, o filtro deve ser centrado em filtro.
[in, optional] Sleep
Um ponteiro para uma função que manipula solicitações de suspensão para o dispositivo. Se NULL, nenhum retorno de chamada de suspensão será registrado. Para obter mais informações, consulte a seção Comentários abaixo.
[in, optional] Wake
Um ponteiro para uma função que manipula solicitações de ativação para o dispositivo. Se NULL, nenhum retorno de chamada de ativação será especificado. Para obter mais informações, consulte a seção Comentários abaixo.
Retornar valor
Nenhum
Comentários
Aviso
Não tente obter o mutex de controle de filtro* de dentro do retorno de chamada De suspensão ou de ativação ou deadlock pode ocorrer. Para obter mais informações sobre mutexes, leia Mutexes no AVStream.
Os dois retornos de chamada devem ser protótipos da seguinte maneira:
void Sleep/Wake (IN PKSFILTER Filter, IN DEVICE_POWER_STATE State);
O retorno de chamada de suspensão será feito se Filter for um filtro centrado em filtro e o dispositivo for dormir. O retorno de chamada de ativação será feito se Filter for um filtro centrado em filtro e o dispositivo estiver acordando.
Para obter informações sobre os estados de energia do dispositivo, consulte Device Power States.
Consulte também Inicializando um minidriver AVStream e processamento centrado em filtro.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| Plataforma de Destino | Universal |
| Cabeçalho | ks.h (inclua Ks.h) |
| Biblioteca | Ks.lib |
| IRQL | PASSIVE_LEVEL |