функция обратного вызова 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 ранее получал этот дескриптор в качестве параметра hMiracastDeviceHandle при вызове функции CreateMiracastContext .

[in, optional] pNotificationContext

Контекст, который будет передан функции pfnDataRateNotify при изменении скорости данных Miracast.

[in, optional] pfnDataRateNotify

Указатель на подпрограмму драйвера, которая будет вызываться при изменении скорости передачи данных сетевого канала Miracast. Дополнительные сведения см. в разделе Примечания.

Драйвер может указать значение NULL для отмены регистрации уведомлений.

Возвращаемое значение

Если операционная система успешно регистрирует или отменяет регистрацию драйвера для уведомлений, она возвращает STATUS_SUCCESS.

В противном случае могут быть возвращены следующие коды ошибок:

Код возврата Описание
STATUS_INVALID_PARAMETER Один или несколько параметров являются недопустимыми.
STATUS_NOT_SUPPORTED Операционная система не может поддерживать уведомления о качестве обслуживания (QoS) или вызов функции выполняется за пределами вызывающего потока, в котором операционная система называется StartMiracastSession или StopMiracastSession .

Комментарии

Драйвер пользовательского режима может при необходимости вызвать эту функцию, чтобы зарегистрироваться для автоматических вызовов функций обратного вызова уведомления о скорости данных раз в секунду.

Чтобы отменить регистрацию в уведомлениях, драйвер должен указать значение NULL для параметра pfnDataRateNotify и элемента CurrentBitRateструктуры MIRACAST_WFD_CONNECTION_STATS , на которую указывает параметр pWfdConnectionStats при вызове функции StartMiracastSession . Когда операционная система получает значение NULL для pfnDataRateNotify и CurrentBitRate, она больше не будет предоставлять уведомления.

Кроме того, если операционная система больше не может предоставлять данные качества обслуживания, она устанавливает для параметра pDataRateStatsзначение NULL при вызове функции pfnDataRateNotify .

Функция завершается ошибкой, если драйвер пытается зарегистрировать, когда он уже зарегистрирован, или если он пытается отменить регистрацию, если он уже отменен. Функция завершается ошибкой, если вызов выполняется за пределами вызывающего потока, в котором операционная система называется StartMiracastSession или StopMiracastSession .

Требования

Требование Значение
Минимальная версия клиента Windows 8.1
Минимальная версия сервера Windows Server 2012 R2
Целевая платформа Персональный компьютер
Верхняя часть netdispumdddi.h (включая Netdispumdddi.h)

См. также раздел

CreateMiracastContext

MIRACAST_WFD_CONNECTION_STATS

StartMiracastSession

pfnDataRateNotify