PFN_REGISTER_DATARATE_NOTIFICATIONS回呼函式 (netdispumdddi.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 函式。 |
備註
使用者模式驅動程式可以選擇性地呼叫此函式，以每秒註冊自動呼叫數據速率通知回呼函式。
若要從通知取消註冊，驅動程式應該為 pfnDataRateNotify 參數提供 NULL 值，以及呼叫 StartMiracastSession 函式時，pWfdConnectionStats 參數所指向之 MIRACAST_WFD_CONNECTION_STATS 結構的 CurrentBitRate 成員。 當操作系統同時收到 pfnDataRateNotify 和 CurrentBitRate的 NULL 時，它將不再提供通知。
此外，如果操作系統無法再提供 QoS 數據，它會在呼叫 pfnDataRateNotify 函式時，將 pDataRateStats 參數設定為 NULL。
如果驅動程式嘗試在已註冊時註冊函式，或嘗試在尚未註冊時取消註冊，則函式會失敗。 如果在呼叫線程之外進行呼叫，則函式會失敗，其中操作系統稱為 StartMiracastSession 或 StopMiracastSession 函 式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8.1 |
| 最低支援的伺服器 | Windows Server 2012 R2 |
| 目標平台 | 桌面 |
| 標頭 | netdispumdddi.h (包含 Netdispumdddi.h) |