Método IAudioEndpointVolumeCallback::OnNotify (endpointvolume.h)

El método OnNotify notifica al cliente que el nivel de volumen o el estado de silenciación del dispositivo de punto de conexión de audio ha cambiado.

Sintaxis

HRESULT OnNotify(
  [in] PAUDIO_VOLUME_NOTIFICATION_DATA pNotify
);

Parámetros

[in] pNotify

Puntero a los datos de notificación por volumen. Este parámetro apunta a una estructura de tipo AUDIO_VOLUME_NOTIFICATION_DATA.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, devuelve un código de error.

Comentarios

El parámetro pNotify apunta a una estructura que describe el evento de cambio de volumen que inició la llamada a OnNotify. Esta estructura contiene un GUID de contexto de evento. Este GUID permite a un cliente distinguir entre un cambio de volumen (o silenciar) que inició y otro iniciado por el cliente. Al llamar a un método IAudioEndpointVolume que cambia el nivel de volumen de la secuencia, un cliente pasa un puntero a un GUID de contexto de evento que su implementación del método OnNotify puede reconocer. La estructura a la que apunta pNotify contiene este GUID de contexto. Si el cliente que cambia el nivel de volumen proporciona un valor de puntero NULL para el puntero al GUID de contexto de evento, el valor del GUID de contexto de evento en la estructura a la que apunta pNotify se GUID_NULL.

Windows 7, la interfaz de usuario de volumen del sistema no especifica GUID_NULL cuando cambia el volumen del sistema. Una aplicación de OSD de terceros puede diferenciar entre los cambios de control de volumen maestros resultantes de la interfaz de usuario del volumen del sistema y otros cambios de volumen, como los cambios del controlador de control de volumen integrado.

Para obtener un ejemplo de código que implementa el método OnNotify , consulte Controles de volumen de puntos de conexión.

Requisitos

Consulte también

AUDIO_VOLUME_NOTIFICATION_DATA

IAudioEndpointVolume (interfaz)

IAudioEndpointVolumeCallback (Interfaz)