PFN_START_MIRACAST_SESSION função de retorno de chamada (netdispumdddi.h)

Artigo
02/07/2025

Chamado pelo sistema operacional para iniciar uma sessão conectada do Miracast.

Sintaxe

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

Um ponteiro para um contexto associado a um adaptador de exibição.

O sistema operacional obteve o contexto quando chamou a função createMiracastContext do driver do modo de usuário miracast.

[in] MiracastRTSPSocket

O identificador de soquete de rede fornecido pelo sistema operacional do RTSP (Protocolo de Streaming em Tempo Real).

Observação o driver do modo de usuário miracast não deve fechar esse soquete. Quando a função StopMiracastSession for chamada, o sistema operacional fechará esse soquete.

[in] pWfdConnectionStats

Um ponteiro para uma estrutura de MIRACAST_WFD_CONNECTION_STATS que indica a Wi-Fi estatísticas de conexão direta.

[out] pSessionInfo

Um ponteiro para uma estrutura de MIRACAST_SESSION_INFO que o driver do modo de usuário miracast deve concluir depois de obter os recursos do coletor Miracast.

Valor de retorno

Com êxito, essa função retorna STATUS_SUCCESS. Caso contrário, a função retornará um código de erro definido no cabeçalho Ntstatus.h, incluindo o seguinte:

Código de retorno	Descrição
STATUS_DEVICE_INSUFFICIENT_RESOURCES	A taxa de codificação sugerida atual não pode sustentar um coletor Miracast que dê suporte a mais de 1024 x 768 pixels.

Observações

Quando essa função é chamada, o driver do modo de usuário miracast deve começar a se comunicar com o coletor Miracast usando o protocolo Miracast. O driver deve reunir os recursos do coletor e os atributos do monitor que está conectado ao coletor. O driver deve executar o suficiente da negociação com o coletor para determinar se um monitor está conectado ao coletor ou não. Se o driver determinar que um monitor está conectado ao coletor, ele também deve determinar se a taxa de bits sugerida atual é alta o suficiente para, pelo menos, dar suporte ao modo de coletor mais baixo com suporte de 1024 x 768 pixels.

O driver também deve definir o valor desses membros de MIRACAST_SESSION_INFO apontados por pSessionInfo nestes casos:

Segurança de thread

O sistema operacional garante que apenas uma das funções CreateMiracastContext, DestroyMiracastContext, StartMiracastSessione stopMiracastSession seja chamada por vez.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8.1
servidor com suporte mínimo	Windows Server 2012 R2
da Plataforma de Destino	Área de trabalho
cabeçalho	netdispumdddi.h (include Netdispumdddi.h)