KsFilterRegisterPowerCallbacks 函数 (ks.h)
KsFilterRegisterPowerCallbacks 函数为 Filter 注册电源管理回调。
语法
void KsFilterRegisterPowerCallbacks(
[in] PKSFILTER Filter,
[in, optional] PFNKSFILTERPOWER Sleep,
[in, optional] PFNKSFILTERPOWER Wake
);
参数
[in] Filter
指向要为其注册电源回调的 KSFILTER 结构的指针。 若要接收电源通知消息， 筛选器 必须以筛选器为中心。
[in, optional] Sleep
指向处理设备的睡眠请求的函数的指针。 如果 为 NULL，则不注册睡眠回调。 有关详细信息，请参阅下面的“备注”部分。
[in, optional] Wake
指向处理设备的唤醒请求的函数的指针。 如果 为 NULL，则不指定唤醒回调。 有关详细信息，请参阅下面的“备注”部分。
返回值
无
备注
警告
请勿尝试从睡眠或唤醒回调中获取筛选器控件互斥体*，否则可能会出现死锁。 有关互斥的详细信息，请阅读 AVStream 中的互斥体。
这两个回调的原型应如下所示：
void Sleep/Wake (IN PKSFILTER Filter, IN DEVICE_POWER_STATE State);
如果 Filter 是以筛选器为中心的筛选器，并且设备要进入睡眠状态，则进行睡眠回调。 如果 Filter 是以筛选器为中心的筛选器，并且设备正在唤醒，则进行唤醒回调。
有关设备电源状态的信息，请参阅 设备电源状态。
另请参阅 初始化 AVStream 微型驱动程序 和 以筛选器为中心的处理。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 适用于 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX。 |
| 目标平台 | 通用 |
| 标头 | ks.h (包括 Ks.h) |
| Library | Ks.lib |
| IRQL | PASSIVE_LEVEL |