IOCTL_BTHHFP_SPEAKER_GET_VOLUME_STATUS_UPDATE IOCTL (bthhfpddi.h)

Artículo
02/22/2024

El IOCTL_BTHHFP_SPEAKER_GET_VOLUME_STATUS_UPDATE IOCTL Obtiene la configuración de nivel de volumen del altavoz del dispositivo Bluetooth.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

Un BOOL que se establece en TRUE para solicitar una actualización inmediata. De lo contrario, establézcalo en FALSE.

Longitud del búfer de entrada

Tamaño de una BOOL.

Búfer de salida

Long que representa el nivel de volumen del hablante en decibelios 1/65536.

Longitud del búfer de salida

Tamaño de un long.

Bloque de estado

Si una solicitud ya está pendiente de que se produzca un error en la nueva solicitud y se devuelva un mensaje de STATUS_INVALID_DEVICE_REQUEST.

Comentarios

Esta solicitud se completará inmediatamente si el parámetro de entrada es TRUE o si el estado del volumen ha cambiado desde la última solicitud. De lo contrario, esta solicitud permanecerá pendiente hasta que cambie el estado del volumen o se cancele la solicitud.

El controlador de audio envía esta solicitud para obtener los niveles iniciales de volumen del altavoz y micrófono, y envía las solicitudes posteriores "pidiendo" que se actualicen cuando cambien los niveles. El controlador almacena los niveles de volumen en los datos de contexto adecuados. Cuando cambia el nivel de volumen, el controlador de audio genera el evento KSEVENT_CONTROL_CHANGE para el nodo KSNODETYPE_VOLUME en la topología KS del altavoz o la ruta de acceso del micrófono.

El parámetro de salida de la solicitud es el mismo que el valor de la propiedad KSPROPERTY_AUDIO_VOLUMELEVEL .