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

[in, optional] pNotificationContext

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

[in, optional] pfnDataRateNotify

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

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

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

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

В противном случае эти коды ошибок можно вернуть:

Замечания

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

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

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

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

Требования

См. также

CreateMiracastContext

MIRACAST_WFD_CONNECTION_STATS

StartMiracastSession

pfnDataRateNotify