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

指向指示 Wi-Fi 直接连接统计信息的 MIRACAST_WFD_CONNECTION_STATS 结构的指针。

[out] pSessionInfo

指向 Miracast 用户模式驱动程序在获取 Miracast 接收器功能后应完成的 MIRACAST_SESSION_INFO 结构的指针。

返回值

成功后，此函数返回 STATUS_SUCCESS。否则，该函数将返回 Ntstatus.h 标头中定义的错误代码，包括以下内容：

返回代码	描述
STATUS_DEVICE_INSUFFICIENT_RESOURCES	当前建议的编码速率无法维持支持 1024 x 768 像素以上的 Miracast 接收器。

言论

调用此函数时，Miracast 用户模式驱动程序应开始使用 Miracast 协议与 Miracast 接收器通信。驱动程序应收集接收器的功能以及连接到接收器的监视器的属性。驱动程序应执行与接收器的足够协商，以确定监视器是否连接到接收器。如果驱动程序确定监视器已连接到接收器，还应确定当前建议的比特率是否足够高，至少支持最低接收器支持的 1024 x 768 像素模式。

在这些情况下，驱动程序还应设置 pSessionInfo 指向 MIRACAST_SESSION_INFO 的这些成员的值：

线程安全

作系统保证一次只调用一个 CreateMiracastContext、DestroyMiracastContext、StartMiracastSession和 StopMiracastSession 函数之一。

要求

要求	价值
最低支持的客户端	Windows 8.1
支持的最低服务器	Windows Server 2012 R2
目标平台	桌面
标头	netdispumdddi.h （include Netdispumdddi.h）