PFN_REGISTER_DATARATE_NOTIFICATIONS función de devolución de llamada (netdispumdddi.h)

Lo llama el controlador en modo de usuario para registrarse en el sistema operativo para recibir notificaciones de calidad de servicio (QoS) de red y el ancho de banda de red actual de la conexión miracast. El tipo de datos de esta función es PFN_REGISTER_DATARATE_NOTIFICATIONS.

Sintaxis

PFN_REGISTER_DATARATE_NOTIFICATIONS PfnRegisterDatarateNotifications;

NTSTATUS PfnRegisterDatarateNotifications(
  [in]           HANDLE hMiracastDeviceHandle,
  [in, optional] PVOID pNotificationContext,
  [in, optional] PFN_DATARATE_NOTIFICATION pfnDataRateNotify
)
{...}

Parámetros

[in] hMiracastDeviceHandle

Identificador que representa un dispositivo Miracast. El controlador del modo de usuario de Miracast obtuvo previamente este identificador como el parámetro hMiracastDeviceHandle en una llamada a la función CreateMiracastContext .

[in, optional] pNotificationContext

Contexto que se pasará a la función pfnDataRateNotify cuando cambie la velocidad de datos de Miracast.

[in, optional] pfnDataRateNotify

Puntero a la rutina del controlador que se llamará cuando la velocidad de bits del vínculo de red de Miracast haya cambiado. Consulta Comentarios para obtener más información.

El controlador puede proporcionar un valor NULL para anular el registro de las notificaciones.

Valor devuelto

Si el sistema operativo registra o anula correctamente el registro del controlador para las notificaciones, devuelve STATUS_SUCCESS.

De lo contrario, se pueden devolver estos códigos de error:

Comentarios

El controlador en modo de usuario puede llamar opcionalmente a esta función para registrarse para las llamadas automáticas a las funciones de devolución de llamada de notificación de frecuencia de datos una vez por segundo.

Para anular el registro de las notificaciones, el controlador debe proporcionar un valor NULL para el parámetro pfnDataRateNotify y para el miembro CurrentBitRate de la estructura MIRACAST_WFD_CONNECTION_STATS a la que apunta el parámetro pWfdConnectionStats cuando llama a la función StartMiracastSession . Cuando el sistema operativo recibe NULL para pfnDataRateNotify y CurrentBitRate, ya no proporcionará notificaciones.

Además, si el sistema operativo ya no puede proporcionar datos de QoS, establece el parámetro pDataRateStats en NULL cuando se llama a la función pfnDataRateNotify .

Se produce un error en la función si el controlador intenta registrarse mientras ya está registrado o si intenta anular el registro si ya se ha anulado el registro. La función produce un error si la llamada se realiza fuera del subproceso de llamada en el que el sistema operativo llamó a las funciones StartMiracastSession o StopMiracastSession .

Requisitos

Consulte también

CreateMiracastContext

MIRACAST_WFD_CONNECTION_STATS

StartMiracastSession

pfnDataRateNotify