Metodo IAudioEndpointVolumeCallback::OnNotify (endpointvolume.h)

Il metodo OnNotify notifica al client che il livello del volume o lo stato di disattivazione del dispositivo dell'endpoint audio è stato modificato.

Sintassi

HRESULT OnNotify(
  [in] PAUDIO_VOLUME_NOTIFICATION_DATA pNotify
);

Parametri

[in] pNotify

Puntatore ai dati di notifica del volume. Questo parametro punta a una struttura di tipo AUDIO_VOLUME_NOTIFICATION_DATA.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, viene restituito un codice di errore.

Commenti

Il parametro pNotify punta a una struttura che descrive l'evento di modifica del volume che ha avviato la chiamata a OnNotify. Questa struttura contiene un GUID del contesto di evento. Questo GUID consente a un client di distinguere tra una modifica di volume (o disattivazione) avviata e quella avviata da un altro client. Quando si chiama un metodo IAudioEndpointVolume che modifica il livello di volume del flusso, un client passa un puntatore a un GUID del contesto di evento che l'implementazione del metodo OnNotify può riconoscere. La struttura a cui punta pNotify contiene questo GUID di contesto. Se il client che modifica il livello del volume fornisce un valore del puntatore NULL per il puntatore al GUID del contesto eventi, il valore del GUID del contesto eventi nella struttura a cui punta pNotify è GUID_NULL.

Windows 7, l'interfaccia utente del volume del sistema non specifica GUID_NULL quando modifica il volume nel sistema. Un'applicazione OSD di terze parti può distinguere tra le modifiche al controllo del volume master risultanti dall'interfaccia utente del volume del sistema e altre modifiche al volume, ad esempio le modifiche apportate dal gestore di controllo del volume predefinito.

Per un esempio di codice che implementa il metodo OnNotify , vedere Controlli del volume degli endpoint.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	endpointvolume.h

Vedi anche

AUDIO_VOLUME_NOTIFICATION_DATA

Interfaccia IAudioEndpointVolume

Interfaccia IAudioEndpointVolumeCallback