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

Artículo
02/07/2025

Llamado por 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 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 MIRACAST_WFD_CONNECTION_STATS que indica las estadísticas de conexión directa Wi-Fi.

[out] pSessionInfo

Puntero a una estructura de MIRACAST_SESSION_INFO que el controlador del modo de usuario de Miracast debe completar después de haber obtenido las funcionalidades del receptor 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 de Miracast que admita más de 1024 x 768 píxeles.

Observaciones

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 funcionalidades del receptor y los atributos del monitor que está conectado al receptor. El controlador debe realizar suficiente 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 apuntado por pSessionInfo en estos casos:

Seguridad de subprocesos

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

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 8.1
servidor mínimo admitido	Windows Server 2012 R2
de la plataforma de destino de	Escritorio
encabezado de	netdispumdddi.h (include Netdispumdddi.h)