PFN_REGISTER_DATARATE_NOTIFICATIONS回调函数 (netdispumddi.h)
由用户模式驱动程序调用，以注册到操作系统，以接收网络服务质量 (QoS) 通知和 Miracast 连接的当前网络带宽。此函数的数据类型PFN_REGISTER_DATARATE_NOTIFICATIONS。
语法
PFN_REGISTER_DATARATE_NOTIFICATIONS PfnRegisterDatarateNotifications;
NTSTATUS PfnRegisterDatarateNotifications(
[in] HANDLE hMiracastDeviceHandle,
[in, optional] PVOID pNotificationContext,
[in, optional] PFN_DATARATE_NOTIFICATION pfnDataRateNotify
)
{...}
参数
[in] hMiracastDeviceHandle
表示 Miracast 设备的句柄。 Miracast 用户模式驱动程序之前在调用 CreateMiracastContext 函数时获取此句柄作为 hMiracastDeviceHandle 参数。
[in, optional] pNotificationContext
当 Miracast 数据速率更改时将传递给 pfnDataRateNotify 函数的上下文。
[in, optional] pfnDataRateNotify
指向在 Miracast 网络链接的比特率发生更改时将调用的驱动程序例程的指针。 有关详细信息，请参阅备注。
驱动程序可以提供 NULL 值来取消注册通知。
返回值
如果操作系统成功注册或注销驱动程序以获取通知，它将返回 STATUS_SUCCESS。
否则，可能会返回以下错误代码：
| 返回代码 | 说明 |
|---|---|
| STATUS_INVALID_PARAMETER | 一个或多个参数无效。 |
| STATUS_NOT_SUPPORTED | 操作系统无法支持 QoS) 通知 (服务质量，或者对函数的调用是在调用线程之外进行的，而操作系统在其中称为 StartMiracastSession 或 StopMiracastSession 函数。 |
注解
用户模式驱动程序可以选择调用此函数，以注册每秒一次对数据速率通知回调函数的自动调用。
若要从通知中注销，驱动程序应在调用 StartMiracastSession 函数时为 pfnDataRateNotify 参数和 pWfdConnectionStats 参数指向的 MIRACAST_WFD_CONNECTION_STATS 结构的 CurrentBitRate 成员提供 NULL 值。 当操作系统同时收到 pfnDataRateNotify 和 CurrentBitRate 的 NULL 时，它将不再提供通知。
此外，如果操作系统无法再提供 QoS 数据，则会在调用 pfnDataRateNotify 函数时将 pDataRateStats 参数设置为 NULL。
如果驱动程序在已注册时尝试注册，或者如果已取消注册，则函数将失败。 如果调用是在调用线程之外进行的，则函数失败，其中操作系统称为 StartMiracastSession 或 StopMiracastSession 函数。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8.1 |
| 最低受支持的服务器 | Windows Server 2012 R2 |
| 目标平台 | 桌面 |
| 标头 | netdispumdddi.h (包括 Netdispumddi.h) |