Função KsFilterRegisterPowerCallbacks (ks.h)
A função KsFilterRegisterPowerCallbacks registra retornos de chamada de gerenciamento de energia para de filtro de.
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, Filtrar 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.
Valor de retorno
Nenhum
Observações
Aviso
Não tente obter o controle de filtro mutex* 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 do Sleep será feito se Filter for um filtro centrado em filtro e o dispositivo dormir. O retorno de chamada do Wake será feito se Filter for um filtro centrado em filtro e o dispositivo estiver acordando.
Para obter informações sobre estados de energia do dispositivo, consulte Device Power States.
Consulte também Inicializando um minidriver AVStream e Filter-Centric processando.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| da Plataforma de Destino | Universal |
| cabeçalho | ks.h (incluir Ks.h) |
| biblioteca | Ks.lib |
| IRQL | PASSIVE_LEVEL |