PFN_START_MIRACAST_SESSION回呼函式 (netdispumdddi.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

指出 Wi-Fi 直接連線統計數據之MIRACAST_WFD_CONNECTION_STATS 結構的指標。

[out] pSessionInfo

在Miracast使用者模式驅動程式取得Miracast接收的功能之後，該 MIRACAST_SESSION_INFO 結構的指標應該完成。

傳回值

成功時，此函式會傳回 STATUS_SUCCESS。否則，函式會傳回 Ntstatus.h 標頭中定義的錯誤碼，包括下列內容：

傳回碼	Description
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 (包含 Netdispumdddi.h)