PFN_START_MIRACAST_SESSION Rückruffunktion (netdispumdddi.h)

Artikel
02/29/2024

Wird 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 einer Grafikkarte zugeordnet ist.

Das Betriebssystem hat den Kontext abgerufen, wenn es 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 Direktverbindungsstatistik angibt.

[out] pSessionInfo

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

Rückgabewert

Bei Erfolg gibt diese Funktion STATUS_SUCCESS zurück. Andernfalls gibt die Funktion einen im Ntstatus.h-Header definierten Fehlercode zurück, einschließlich:

Rückgabecode	Beschreibung
STATUS_DEVICE_INSUFFICIENT_RESOURCES	Die derzeit vorgeschlagene Codierungsrate kann eine Miracast-Senke nicht unterstützen, die mehr als 1024 x 768 Pixel unterstützt.

Hinweise

Wenn diese Funktion aufgerufen wird, sollte der Miracast-Benutzermodustreiber mit der Kommunikation mit der Miracast-Senke über das Miracast-Protokoll beginnen. Der Treiber sollte die Funktionen der Senke und die Attribute des Monitors erfassen, der mit der Senke verbunden ist. Der Treiber sollte genügend Aushandlung mit der Senke ausführen, um zu bestimmen, ob ein Monitor mit der Senke verbunden ist oder nicht. Wenn der Treiber feststellt, dass ein Monitor mit der Senke verbunden ist, sollte er auch bestimmen, ob die aktuell vorgeschlagene Bitrate hoch genug ist, um mindestens den niedrigsten unterstützten Senkenmodus von 1024 x 768 Pixeln zu unterstützen.

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

Threadsicherheit

Das Betriebssystem garantiert, dass nur eine der Funktionen CreateMiracastContext, DestroyMiracastContext, StartMiracastSession und StopMiracastSession gleichzeitig aufgerufen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1
Unterstützte Mindestversion (Server)	Windows Server 2012 R2
Zielplattform	Desktop
Kopfzeile	netdispumdddi.h (include Netdispumdddi.h)