PFN_START_MIRACAST_SESSION funzione di callback (netdispumdddi.h)

Articolo
02/07/2025

Chiamato dal sistema operativo per avviare una sessione connessa Miracast.

Sintassi

PFN_START_MIRACAST_SESSION PfnStartMiracastSession;

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

Parametri

[in] pMiracastContext

Puntatore a un contesto associato a una scheda di visualizzazione.

Il sistema operativo ha ottenuto il contesto quando ha chiamato la funzione createMiracastContext del driver miracast.

[in] MiracastRTSPSocket

Handle del socket di rete fornito dal sistema operativo del protocollo RTSP (Real Time Streaming Protocol).

Nota Il driver in modalità utente Miracast non deve chiudere questo socket. Quando viene chiamata la funzione StopMiracastSession, il sistema operativo chiuderà questo socket.

[in] pWfdConnectionStats

Puntatore a una struttura MIRACAST_WFD_CONNECTION_STATS che indica le statistiche di connessione diretta Wi-Fi.

[out] pSessionInfo

Puntatore a una struttura MIRACAST_SESSION_INFO che il driver miracast in modalità utente deve completare dopo aver ottenuto le funzionalità del sink Miracast.

Valore restituito

In caso di esito positivo, questa funzione restituisce STATUS_SUCCESS. In caso contrario, la funzione restituisce un codice di errore definito nell'intestazione Ntstatus.h, incluso quanto segue:

Codice restituito	Descrizione
STATUS_DEVICE_INSUFFICIENT_RESOURCES	La velocità di codifica suggerita corrente non può sostenere un sink Miracast che supporta più di 1024 x 768 pixel.

Osservazioni

Quando questa funzione viene chiamata, il driver miracast in modalità utente deve iniziare a comunicare con il sink Miracast usando il protocollo Miracast. Il driver deve raccogliere le funzionalità del sink e gli attributi del monitor connesso al sink. Il driver deve eseguire una quantità sufficiente di negoziazione con il sink per determinare se un monitor è connesso al sink o meno. Se il driver determina che un monitor è connesso al sink, deve anche determinare se la velocità di bit suggerita corrente è sufficientemente elevata per supportare almeno la modalità di sink più bassa supportata di 1024 x 768 pixel.

Il driver deve anche impostare il valore di questi membri di MIRACAST_SESSION_INFO a cui punta pSessionInfo in questi casi:

Thread Safety

Il sistema operativo garantisce che solo una delle CreateMiracastContext, DestroyMiracastContext, StartMiracastSessione funzioni StopMiracastSession viene chiamata alla volta.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8.1
server minimo supportato	Windows Server 2012 R2
piattaforma di destinazione	Desktop
intestazione	netdispumdddi.h (include Netdispumddi.h)