共用方式為


PFN_START_MIRACAST_SESSION回呼函式 (netdispumdddi.h)

由作系統呼叫以啟動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。

[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 像素的最低接收支援模式。

驅動程式也應該在這些情況下,設定 pSessionIn fo 所指向之 MIRACAST_SESSION_INFO 這些成員的值:

線程安全性

作系統保證一次只會呼叫其中一個 CreateMiracastContextDestroyMiracastContextStartMiracastSessionStopMiracastSession 函式。

要求

要求 價值
最低支援的用戶端 Windows 8.1
支援的最低伺服器 Windows Server 2012 R2
目標平臺 桌面
標頭 netdispumdddi.h (include Netdispumdddi.h)

另請參閱

CreateMiracastContext

DestroyMiracastContext

MIRACAST_SESSION_INFO

MIRACAST_WFD_CONNECTION_STATS

StopMiracastSession