PFN_START_MIRACAST_SESSION fonction de rappel (netdispumdddi.h)

Article
02/29/2024

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 utilisateur Miracast.

[in] MiracastRTSPSocket

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

Note 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 de MIRACAST_WFD_CONNECTION_STATS qui indique le Wi-Fi statistiques de connexion directe.

[out] pSessionInfo

Pointeur vers une structure MIRACAST_SESSION_INFO que le pilote en mode utilisateur Miracast doit effectuer une fois qu’il a obtenu les fonctionnalités du récepteur Miracast.

Valeur retournée

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 :

Code de retour	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 1 024 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 rassembler 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é ou non au récepteur. Si le pilote détermine qu’un moniteur est connecté au récepteur, il doit également déterminer si le débit binaire suggéré actuel est suffisamment élevé pour prendre en charge au moins le mode récepteur le plus bas pris en charge, à savoir 1 024 x 768 pixels.

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

Cohérence de thread

Le système d’exploitation garantit qu’une seule des fonctions CreateMiracastContext, DestroyMiracastContext, StartMiracastSession et StopMiracastSession est appelée à la fois.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1
Serveur minimal pris en charge	Windows Server 2012 R2
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	netdispumdddi.h (inclure Netdispumdddi.h)