PFN_REGISTER_DATARATE_NOTIFICATIONS Rückruffunktion (netdispumdddi.h)
Wird vom Benutzermodustreiber aufgerufen, um sich beim Betriebssystem zu registrieren, um QoS-Benachrichtigungen (Network Quality of Service) und die aktuelle Netzwerkbandbreite der Miracast-Verbindung zu erhalten. Der Datentyp dieser Funktion ist PFN_REGISTER_DATARATE_NOTIFICATIONS.
Syntax
PFN_REGISTER_DATARATE_NOTIFICATIONS PfnRegisterDatarateNotifications;
NTSTATUS PfnRegisterDatarateNotifications(
[in] HANDLE hMiracastDeviceHandle,
[in, optional] PVOID pNotificationContext,
[in, optional] PFN_DATARATE_NOTIFICATION pfnDataRateNotify
)
{...}
Parameter
[in] hMiracastDeviceHandle
Ein Handle, das ein Miracast-Gerät darstellt. Der Miracast-Benutzermodustreiber hat dieses Handle zuvor als hMiracastDeviceHandle-Parameter in einem Aufruf der CreateMiracastContext-Funktion abgerufen.
[in, optional] pNotificationContext
Der Kontext, der an die pfnDataRateNotify-Funktion übergeben wird, wenn sich die Miracast-Datenrate ändert.
[in, optional] pfnDataRateNotify
Ein Zeiger auf die Treiberroutine, die aufgerufen wird, wenn sich die Bitrate der Miracast-Netzwerkverbindung geändert hat. Weitere Informationen finden Sie unter Hinweise.
Der Treiber kann einen NULL-Wert angeben, um die Registrierung für Benachrichtigungen aufzuheben.
Rückgabewert
Wenn das Betriebssystem den Treiber erfolgreich für Benachrichtigungen registriert oder auf hebt, wird STATUS_SUCCESS zurückgegeben.
Andernfalls können diese Fehlercodes zurückgegeben werden:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_PARAMETER | Mindestens ein Parameter ist ungültig. |
| STATUS_NOT_SUPPORTED | Das Betriebssystem kann keine QoS-Benachrichtigungen (Quality of Service) unterstützen, oder der Aufruf der Funktion erfolgt außerhalb des aufrufenden Threads, in dem das Betriebssystem Die Funktionen StartMiracastSession oder StopMiracastSession aufgerufen hat. |
Hinweise
Der Benutzermodustreiber kann diese Funktion optional aufrufen, um sich einmal pro Sekunde für automatische Aufrufe von Datenratenbenachrichtigungsrückruffunktionen zu registrieren.
Um die Registrierung von Benachrichtigungen aufzuheben, muss der Treiber den Wert NULL für den PfnDataRateNotify-Parameter und für den CurrentBitRate-Member der MIRACAST_WFD_CONNECTION_STATS Struktur angeben, auf die der pWfdConnectionStats-Parameter verweist, wenn er die StartMiracastSession-Funktion aufruft. Wenn das Betriebssystem sowohl für pfnDataRateNotify als auch für CurrentBitRateNULL empfängt, werden keine Benachrichtigungen mehr bereitgestellt.
Wenn das Betriebssystem keine QoS-Daten mehr bereitstellen kann, wird der pDataRateStats-Parameter auf NULL festgelegt, wenn die PfnDataRateNotify-Funktion aufgerufen wird.
Die Funktion schlägt fehl, wenn der Treiber versucht, sich zu registrieren, während er bereits registriert ist, oder wenn er versucht, die Registrierung aufzuheben, wenn die Registrierung bereits aufgehoben wurde. Die Funktion schlägt fehl, wenn der Aufruf außerhalb des aufrufenden Threads erfolgt, in dem das Betriebssystem die Funktionen StartMiracastSession oder StopMiracastSession aufgerufen hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1 |
| Unterstützte Mindestversion (Server) | Windows Server 2012 R2 |
| Zielplattform | Desktop |
| Kopfzeile | netdispumdddi.h (include Netdispumdddi.h) |