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

Chamado pelo driver de modo de usuário para se registrar no sistema operacional para receber notificações de QoS (qualidade de serviço) de rede e a largura de banda de rede atual da conexão Miracast. O tipo de dados dessa função é PFN_REGISTER_DATARATE_NOTIFICATIONS.

Sintaxe

PFN_REGISTER_DATARATE_NOTIFICATIONS PfnRegisterDatarateNotifications;

NTSTATUS PfnRegisterDatarateNotifications(
  [in]           HANDLE hMiracastDeviceHandle,
  [in, optional] PVOID pNotificationContext,
  [in, optional] PFN_DATARATE_NOTIFICATION pfnDataRateNotify
)
{...}

Parâmetros

[in] hMiracastDeviceHandle

Um identificador que representa um dispositivo Miracast. O driver de modo de usuário miracast obteve anteriormente esse identificador como o parâmetro hMiracastDeviceHandle em uma chamada para a função CreateMiracastContext .

[in, optional] pNotificationContext

O contexto que será passado para a função pfnDataRateNotify quando a taxa de dados miracast for alterada.

[in, optional] pfnDataRateNotify

Um ponteiro para a rotina do driver que será chamado quando a taxa de bits do link de rede Miracast for alterada. Consulte Comentários para obter mais informações.

O driver pode fornecer um valor NULL para cancelar o registro de notificações.

Retornar valor

Se o sistema operacional registrar ou cancelar o registro do driver para notificações, ele retornará STATUS_SUCCESS.

Caso contrário, esses códigos de erro podem ser retornados:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER	Um ou mais parâmetros são inválidos.
STATUS_NOT_SUPPORTED	O sistema operacional não pode dar suporte a notificações de QoS (qualidade de serviço) ou a chamada para a função é feita fora do thread de chamada no qual o sistema operacional chamado funções StartMiracastSession ou StopMiracastSession .

Comentários

Opcionalmente, o driver de modo de usuário pode chamar essa função para registrar chamadas automáticas para funções de retorno de chamada de notificação de taxa de dados uma vez por segundo.

Para cancelar o registro das notificações, o driver deve fornecer um valor nulo para o parâmetro pfnDataRateNotify e para o membro CurrentBitRate da estrutura MIRACAST_WFD_CONNECTION_STATS apontada pelo parâmetro pWfdConnectionStats quando chama a função StartMiracastSession . Quando o sistema operacional recebe NULL para pfnDataRateNotify e CurrentBitRate, ele não fornecerá mais notificações.

Além disso, se o sistema operacional não puder mais fornecer dados de QoS, ele definirá o parâmetro pDataRateStats como NULL quando a função pfnDataRateNotify for chamada.

A função falhará se o driver tentar registrar enquanto ele já estiver registrado ou se tentar cancelar o registro se ele já tiver cancelado o registro. A função falhará se a chamada for feita fora do thread de chamada no qual o sistema operacional chamado StartMiracastSession ou StopMiracastSession funciona.

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)

Confira também

CreateMiracastContext

MIRACAST_WFD_CONNECTION_STATS

StartMiracastSession

pfnDataRateNotify