RegisterForDataRateNotifications function pointer

Called by the user-mode driver to register with the operating system to receive network quality of service (QoS) notifications and the current network bandwidth of the Miracast connection.

The data type of this function is PFN_REGISTER_DATARATE_NOTIFICATIONS.

Syntax


typedef NTSTATUS ( *RegisterForDataRateNotifications)(
  _In_      HANDLE hMiracastDeviceHandle,
  _In_opt_  PVOID pNotificationContext,
  _In_opt_  PFN_DATARATE_NOTIFICATION pfnDataRateNotify
);

Parameters

hMiracastDeviceHandle [in]

A handle that represents a Miracast device. The Miracast user-mode driver previously obtained this handle as the hMiracastDeviceHandle parameter in a call to the CreateMiracastContext function.

pNotificationContext [in, optional]

The context that will be passed to the pfnDataRateNotify function when the Miracast data rate changes.

pfnDataRateNotify [in, optional]

A pointer to the driver routine that will be called when the bit rate of the Miracast network link has changed. See Remarks for more info.

The driver can supply a NULL value to unregister for notifications.

Return value

If the operating system successfully registers or unregisters the driver for notifications, it returns STATUS_SUCCESS.

Otherwise, these error codes can be returned:

Return codeDescription
STATUS_INVALID_PARAMETER

One or more parameters are invalid.

STATUS_NOT_SUPPORTED

The operating system cannot support quality of service (QoS) notifications, or the call to the function is made outside of the calling thread in which the operating system called StartMiracastSession or StopMiracastSession functions.

 

Remarks

The user-mode driver can optionally call this function to register for automatic calls to data rate notification callback functions once a second.

To unregister from notifications, the driver should supply a value of NULL for the pfnDataRateNotify parameter and for the CurrentBitRate member of the MIRACAST_WFD_CONNECTION_STATS structure pointed to by the pWfdConnectionStats parameter when it calls the StartMiracastSession function. When the operating system receives NULL for both pfnDataRateNotify and CurrentBitRate, it will no longer provide notifications.

Also, if the operating system can no longer provide QoS data, it sets the pDataRateStats parameter to NULL when the pfnDataRateNotify function is called.

The function fails if the driver attempts to register while it is already registered, or if it attempts to unregister if it has already unregistered. The function fails if the call is made outside of the calling thread in which the operating system called StartMiracastSession or StopMiracastSession functions.

Requirements

Minimum supported client

Windows 8.1

Minimum supported server

Windows Server 2012 R2

Header

Netdispumdddi.h (include Netdispumdddi.h)

See also

CreateMiracastContext
MIRACAST_WFD_CONNECTION_STATS
pfnDataRateNotify
StartMiracastSession

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft