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) |