PFN_START_MIRACAST_SESSION回调函数 (netdispumddi.h)

项目
02/26/2024

由操作系统调用以启动 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	当前建议的编码速率无法维持支持超过 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 (包括 Netdispumddi.h)