PFN_START_MIRACAST_SESSION función de devolución de llamada (netdispumdddi.h)

Artículo
08/07/2023

Lo llama el sistema operativo para iniciar una sesión conectada a Miracast.

Sintaxis

PFN_START_MIRACAST_SESSION PfnStartMiracastSession;

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

Parámetros

[in] pMiracastContext

Puntero a un contexto asociado a un adaptador de pantalla.

El sistema operativo obtuvo el contexto cuando llamó a la función CreateMiracastContext del controlador en modo de usuario de Miracast.

[in] MiracastRTSPSocket

Identificador de socket de red proporcionado por el sistema operativo del Protocolo de streaming en tiempo real (RTSP).

Nota El controlador en modo de usuario de Miracast no debe cerrar este socket. Cuando se llama a la función StopMiracastSession , el sistema operativo cerrará este socket.

[in] pWfdConnectionStats

Puntero a una estructura de MIRACAST_WFD_CONNECTION_STATS que indica la Wi-Fi estadísticas de conexión directa.

[out] pSessionInfo

Puntero a una estructura MIRACAST_SESSION_INFO que el controlador del modo de usuario de Miracast debe completar después de haber obtenido las funcionalidades del receptor de Miracast.

Valor devuelto

Si se ejecuta correctamente, esta función devuelve STATUS_SUCCESS. De lo contrario, la función devuelve un código de error definido en el encabezado Ntstatus.h, incluido lo siguiente:

Código devuelto	Descripción
STATUS_DEVICE_INSUFFICIENT_RESOURCES	La velocidad de codificación sugerida actual no puede admitir un receptor miracast que admita más de 1024 x 768 píxeles.

Comentarios

Cuando se llama a esta función, el controlador del modo de usuario de Miracast debe empezar a comunicarse con el receptor de Miracast mediante el protocolo Miracast. El controlador debe recopilar las funciones del receptor y los atributos del monitor que está conectado al receptor. El controlador debe realizar lo suficiente de la negociación con el receptor para determinar si un monitor está conectado al receptor o no. Si el controlador determina que un monitor está conectado al receptor, también debe determinar si la velocidad de bits sugerida actual es lo suficientemente alta como para admitir al menos el modo de receptor más bajo admitido de 1024 x 768 píxeles.

El controlador también debe establecer el valor de estos miembros de MIRACAST_SESSION_INFO señalado por pSessionInfo en estos casos:

Seguridad para subprocesos

El sistema operativo garantiza que solo se llama a una de las funciones CreateMiracastContext, DestroyMiracastContext, StartMiracastSession y StopMiracastSession .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8.1
Servidor mínimo compatible	Windows Server 2012 R2
Plataforma de destino	Escritorio
Encabezado	netdispumdddi.h (include Netdispumdddi.h)