KsFilterRegisterPowerCallbacks 函数注册 筛选器的电源管理回调。
语法
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);
如果 筛选器 是以筛选器为中心的筛选器，并且设备将进入睡眠状态，则 睡眠 回调。 如果 筛选器 是以筛选器为中心的筛选器，并且设备正在唤醒，则会进行 唤醒 回调。
有关设备电源状态的信息，请参阅 设备电源状态。
另请参阅 初始化 AVStream 微型驱动程序 和 Filter-Centric 处理。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Microsoft Windows XP 及更高版本的作系统以及 DirectX 8.0 及更高版本的 DirectX 版本中提供。 |
| 目标平台 | 普遍 |
| 标头 | ks.h （包括 Ks.h） |
| 库 | Ks.lib |
| IRQL | PASSIVE_LEVEL |