PFN_START_MIRACAST_SESSION Rückruffunktion (netdispumdddi.h)

Artikel
02/07/2025

Vom Betriebssystem aufgerufen, um eine verbundene Miracast-Sitzung zu starten.

Syntax

PFN_START_MIRACAST_SESSION PfnStartMiracastSession;

NTSTATUS PfnStartMiracastSession(
  [in]  PVOID pMiracastContext,
  [in]  SOCKET MiracastRTSPSocket,
  [in]  MIRACAST_WFD_CONNECTION_STATS *pWfdConnectionStats,
  [out] MIRACAST_SESSION_INFO *pSessionInfo
)
{...}

Parameter

[in] pMiracastContext

Ein Zeiger auf einen Kontext, der einem Anzeigeadapter zugeordnet ist.

Das Betriebssystem hat den Kontext erhalten, wenn er die CreateMiracastContext- Funktion des Miracast-Benutzermodustreibers aufgerufen hat.

[in] MiracastRTSPSocket

Das vom Betriebssystem bereitgestellte Netzwerksockethandle des Real Time Streaming Protocol (RTSP).

Hinweis Der Miracast-Benutzermodustreiber sollte diesen Socket nicht schließen. Wenn die StopMiracastSession Funktion aufgerufen wird, schließt das Betriebssystem diesen Socket.

[in] pWfdConnectionStats

Ein Zeiger auf eine MIRACAST_WFD_CONNECTION_STATS Struktur, die die Wi-Fi Statistiken zur direkten Verbindung angibt.

[out] pSessionInfo

Ein Zeiger auf eine MIRACAST_SESSION_INFO Struktur, die der Miracast-Benutzermodustreiber abschließen sollte, nachdem er die Funktionen der Miracast-Spüle erhalten hat.

Rückgabewert

Bei Erfolg gibt diese Funktion STATUS_SUCCESSzurück. Andernfalls gibt die Funktion einen Fehlercode zurück, der im Ntstatus.h-Header definiert ist, einschließlich der folgenden:

Rückgabecode	Beschreibung
STATUS_DEVICE_INSUFFICIENT_RESOURCES	Die aktuelle vorgeschlagene Codierungsrate kann keine Miracast-Spüle erhalten, die mehr als 1024 x 768 Pixel unterstützt.

Bemerkungen

Wenn diese Funktion aufgerufen wird, sollte der Miracast-Benutzermodustreiber mit der Miracast-Spüle mit dem Miracast-Protokoll kommunizieren. Der Treiber sollte die Funktionen der Spüle und die Attribute des Monitors erfassen, der mit der Spüle verbunden ist. Der Fahrer sollte genügend Aushandlung mit der Spüle ausführen, um festzustellen, ob ein Monitor mit der Spüle verbunden ist oder nicht. Wenn der Treiber feststellt, dass ein Monitor mit der Spüle verbunden ist, sollte er auch bestimmen, ob die aktuelle vorgeschlagene Bitrate hoch genug ist, um zumindest den niedrigsten unterstützten Spülemodus von 1024 x 768 Pixeln zu unterstützen.

Der Treiber sollte auch den Wert dieser Member von MIRACAST_SESSION_INFO festlegen, auf die pSessionInfo- in diesen Fällen verweist:

Threadsicherheit

Das Betriebssystem garantiert, dass nur einer der CreateMiracastContext, DestroyMiracastContext, StartMiracastSessionund StopMiracastSession Funktionen gleichzeitig aufgerufen wird.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8.1
mindestens unterstützte Server-	Windows Server 2012 R2
Zielplattform-	Desktop
Header-	netdispumdddi.h (include Netdispumdddi.h)