PFN_START_MIRACAST_SESSION fonction de rappel (netdispumdddi.h)

Article
02/07/2025

Appelé par le système d’exploitation pour démarrer une session connectée Miracast.

Syntaxe

PFN_START_MIRACAST_SESSION PfnStartMiracastSession;

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

Paramètres

[in] pMiracastContext

Pointeur vers un contexte associé à un adaptateur d’affichage.

Le système d’exploitation a obtenu le contexte lorsqu’il a appelé la fonction CreateMiracastContext du pilote en mode utilisateur Miracast.

[in] MiracastRTSPSocket

Handle de socket réseau fourni par le système d’exploitation du protocole RTSP (Real Time Streaming Protocol).

Remarque Le pilote en mode utilisateur Miracast ne doit pas fermer ce socket. Lorsque la fonction StopMiracastSession est appelée, le système d’exploitation ferme ce socket.

[in] pWfdConnectionStats

Pointeur vers une structure MIRACAST_WFD_CONNECTION_STATS qui indique les statistiques de connexion directe Wi-Fi.

[out] pSessionInfo

Pointeur vers une structure MIRACAST_SESSION_INFO que le pilote en mode utilisateur Miracast doit se terminer après avoir obtenu les fonctionnalités du récepteur Miracast.

Valeur de retour

En cas de réussite, cette fonction retourne STATUS_SUCCESS. Sinon, la fonction retourne un code d’erreur défini dans l’en-tête Ntstatus.h, y compris les éléments suivants :

Retourner le code	Description
STATUS_DEVICE_INSUFFICIENT_RESOURCES	Le taux d’encodage suggéré actuel ne peut pas supporter un récepteur Miracast qui prend en charge plus de 1024 x 768 pixels.

Remarques

Lorsque cette fonction est appelée, le pilote en mode utilisateur Miracast doit commencer à communiquer avec le récepteur Miracast à l’aide du protocole Miracast. Le pilote doit collecter les fonctionnalités du récepteur et les attributs du moniteur connecté au récepteur. Le pilote doit effectuer suffisamment de négociation avec le récepteur pour déterminer si un moniteur est connecté au récepteur ou non. Si le pilote détermine qu’un moniteur est connecté au récepteur, il doit également déterminer si le débit de bits suggéré actuel est suffisamment élevé pour au moins prendre en charge le mode le plus bas pris en charge par le récepteur de 1024 x 768 pixels.

Le pilote doit également définir la valeur de ces membres de MIRACAST_SESSION_INFO pointés par pSessionInfo dans les cas suivants :

Sécurité des threads

Le système d’exploitation garantit qu’un seul des CreateMiracastContext, DestroyMiracastContext, StartMiracastSessionet fonctions StopMiracastSession est appelée à la fois.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8.1
serveur minimum pris en charge	Windows Server 2012 R2
plateforme cible	Bureau
d’en-tête	netdispumdddi.h (include Netdispumdddi.h)