PFN_REGISTER_DATARATE_NOTIFICATIONS funzione di callback (netdispumdddi.h)

  • Articolo

Chiamato dal driver in modalità utente per registrarsi con il sistema operativo per ricevere notifiche di qualità del servizio (QoS) e la larghezza di banda di rete corrente della connessione Miracast. Il tipo di dati di questa funzione è PFN_REGISTER_DATARATE_NOTIFICATIONS.

Sintassi

PFN_REGISTER_DATARATE_NOTIFICATIONS PfnRegisterDatarateNotifications;

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

Parametri

[in] hMiracastDeviceHandle

Handle che rappresenta un dispositivo Miracast. Il driver miracast in modalità utente ha ottenuto in precedenza questo handle come parametro hMiracastDeviceHandle in una chiamata alla funzione CreateMiracastContext .

[in, optional] pNotificationContext

Contesto che verrà passato alla funzione pfnDataRateNotify quando cambia la frequenza dei dati Miracast.

[in, optional] pfnDataRateNotify

Puntatore alla routine del driver che verrà chiamata quando è stata modificata la velocità di bit del collegamento di rete Miracast. Per altre info, vedi La sezione Osservazioni.

Il driver può fornire un valore NULL per annullare la registrazione per le notifiche.

Valore restituito

Se il sistema operativo registra o annulla la registrazione del driver per le notifiche, restituisce STATUS_SUCCESS.

In caso contrario, è possibile restituire questi codici di errore:

Codice restituito Descrizione
STATUS_INVALID_PARAMETER Uno o più parametri non sono validi.
STATUS_NOT_SUPPORTED Il sistema operativo non può supportare le notifiche di qualità del servizio (QoS) o la chiamata alla funzione viene effettuata al di fuori del thread chiamante in cui il sistema operativo denominato funzioni StartMiracastSession o StopMiracastSession .

Commenti

Il driver in modalità utente può facoltativamente chiamare questa funzione per eseguire la registrazione per le chiamate automatiche alle funzioni di callback di notifica della frequenza dei dati una volta al secondo.

Per annullare la registrazione dalle notifiche, il driver deve fornire un valore NULL per il parametro pfnDataRateNotify e per il membro CurrentBitRate della struttura MIRACAST_WFD_CONNECTION_STATS a cui punta il parametro pWfdConnectionStats quando chiama la funzione StartMiracastSession . Quando il sistema operativo riceve NULL sia per pfnDataRateNotify che per CurrentBitRate, non fornirà più notifiche.

Inoltre, se il sistema operativo non può più fornire dati QoS, imposta il parametro pDataRateStats su NULL quando viene chiamata la funzione pfnDataRateNotify .

La funzione ha esito negativo se il driver tenta di eseguire la registrazione mentre è già registrato o se tenta di annullare la registrazione se è già stata annullata la registrazione. La funzione ha esito negativo se la chiamata viene eseguita all'esterno del thread chiamante in cui il sistema operativo denominato StartMiracastSession o Le funzioni StopMiracastSession .

Requisiti

Requisito Valore
Client minimo supportato Windows 8.1
Server minimo supportato Windows Server 2012 R2
Piattaforma di destinazione Desktop
Intestazione netdispumdddi.h (include Netdispumdddi.h)

Vedi anche

CreateMiracastContext

MIRACAST_WFD_CONNECTION_STATS

StartMiracastSession

pfnDataRateNotify