функция обратного вызова PFN_START_MIRACAST_SESSION (netdispumdddi.h)

Статья
08/07/2023

Вызывается операционной системой для запуска сеанса, подключенного к Miracast.

Синтаксис

PFN_START_MIRACAST_SESSION PfnStartMiracastSession;

NTSTATUS PfnStartMiracastSession(
  [in]  PVOID pMiracastContext,
  [in]  SOCKET MiracastRTSPSocket,
  [in]  MIRACAST_WFD_CONNECTION_STATS *pWfdConnectionStats,
  [out] MIRACAST_SESSION_INFO *pSessionInfo
)
{...}

Параметры

[in] pMiracastContext

Указатель на контекст, связанный с видеоадаптером.

Операционная система получила контекст при вызове функции CreateMiracastContext драйвера Пользовательского режима Miracast.

[in] MiracastRTSPSocket

Предоставляемый операционной системой дескриптор сетевого сокета протокола RTSP.

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

[in] pWfdConnectionStats

Указатель на структуру MIRACAST_WFD_CONNECTION_STATS , указывающую статистику Wi-Fi прямого подключения.

[out] pSessionInfo

Указатель на структуру MIRACAST_SESSION_INFO , которую должен завершить драйвер пользовательского режима Miracast после получения возможностей приемника Miracast.

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

При успешном выполнении эта функция возвращает STATUS_SUCCESS. В противном случае функция возвращает код ошибки, определенный в заголовке Ntstatus.h, включая следующее:

Код возврата	Описание
STATUS_DEVICE_INSUFFICIENT_RESOURCES	Текущая рекомендуемая скорость кодирования не поддерживает приемник Miracast, поддерживающий более 1024 x 768 пикселей.

При вызове этой функции драйвер пользовательского режима Miracast должен начать взаимодействие со приемником Miracast с помощью протокола Miracast. Драйвер должен собирать возможности приемника и атрибуты монитора, подключенного к приемнику. Драйвер должен выполнить достаточно согласование с приемником, чтобы определить, подключен ли монитор к приемнику. Если драйвер определяет, что монитор подключен к приемнику, он также должен определить, является ли текущая предлагаемая скорость достаточно высокой для поддержки по крайней мере самого низкого поддерживаемого режима приемника 1024 x 768 пикселей.

Драйвер также должен задать значение этих членов MIRACAST_SESSION_INFO , на которые указывает pSessionInfo , в следующих случаях:

Потокобезопасность

Операционная система гарантирует, что одновременно вызывается только одна из функций CreateMiracastContext, DestroyMiracastContext, StartMiracastSession и StopMiracastSession .

Требования

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