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

Статья
02/07/2025

Вызывается операционной системой для запуска подключенного сеанса 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

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

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

[in] MiracastRTSPSocket

Дескриптор сетевого сокета операционной системы протокола потоковой передачи в режиме реального времени (RTSP).

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

[in] pWfdConnectionStats

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

[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 (include Netdispumdddi.h)