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

Artigo
02/29/2024

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 de modo de usuário do Miracast.

[in] MiracastRTSPSocket

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

Nota 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 as estatísticas de conexão direta Wi-Fi.

[out] pSessionInfo

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

Retornar valor

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.

Comentários

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 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 deverá 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:

Acesso thread-safe

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1
Servidor mínimo com suporte	Windows Server 2012 R2
Plataforma de Destino	Área de Trabalho
Cabeçalho	netdispumdddi.h (inclua Netdispumdddi.h)