PFN_START_MIRACAST_SESSION funzione di callback (netdispumdddi.h)

Articolo
02/29/2024

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 in modalità utente 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 in modalità utente Miracast 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 frequenza di codifica consigliata corrente non può sostenere un sink Miracast che supporta più di 1024 x 768 pixel.

Commenti

Quando questa funzione viene chiamata, il driver in modalità utente Miracast 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 abbastanza della 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 frequenza di bit suggerita corrente è sufficiente 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 puntati da pSessionInfo in questi casi:

Thread safety

Il sistema operativo garantisce che solo una delle funzioni CreateMiracastContext, DestroyMiracastContext, StartMiracastSession e StopMiracastSession venga chiamata alla volta.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1
Server minimo supportato	Windows Server 2012 R2
Piattaforma di destinazione	Desktop
Intestazione	netdispumdddi.h (include Netdispumdddi.h)