Función KsFilterRegisterPowerCallbacks (ks.h)
La función KsFilterRegisterPowerCallbacks registra devoluciones de llamada de administración de energía para Filter.
Sintaxis
void KsFilterRegisterPowerCallbacks(
[in] PKSFILTER Filter,
[in, optional] PFNKSFILTERPOWER Sleep,
[in, optional] PFNKSFILTERPOWER Wake
);
Parámetros
[in] Filter
Puntero a la estructura KSFILTER para la que se van a registrar devoluciones de llamada de energía. Para recibir mensajes de notificación de energía, Filter debe centrarse en filtros.
[in, optional] Sleep
Puntero a una función que controla las solicitudes de suspensión del dispositivo. Si es NULL, no se registra ninguna devolución de llamada de suspensión. Para obtener más información, vea la sección Comentarios a continuación.
[in, optional] Wake
Puntero a una función que controla las solicitudes de reactivación del dispositivo. Si es NULL, no se especifica ninguna devolución de llamada de reactivación. Para obtener más información, vea la sección Comentarios a continuación.
Valor devuelto
None
Comentarios
Advertencia
No intente obtener la exclusión mutua del control de filtro* desde la devolución de llamada Sleep o Wake, o bien puede producirse un interbloqueo. Para obtener más información sobre las exclusión mutuas, lea Exclusión mutua en AVStream.
Las dos devoluciones de llamada se deben crear prototipos de la siguiente manera:
void Sleep/Wake (IN PKSFILTER Filter, IN DEVICE_POWER_STATE State);
La devolución de llamada de suspensión se realiza si Filter es un filtro centrado en filtros y el dispositivo se va a suspender. La devolución de llamada wake se realiza si Filter es un filtro centrado en filtros y el dispositivo se está despertando.
Para obtener información sobre los estados de energía del dispositivo, consulte Estados de energía del dispositivo.
Consulte también Inicialización de un minidriver AVStream y procesamiento centrado en filtros.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows XP y sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX. |
| Plataforma de destino | Universal |
| Encabezado | ks.h (incluya Ks.h) |
| Library | Ks.lib |
| IRQL | PASSIVE_LEVEL |