IOCTL_BTHHFP_MIC_GET_VOLUME_STATUS_UPDATE IOCTL (bthhfpddi.h)

Articolo
08/07/2023

Il IOCTL_BTHHFP_MIC_GET_VOLUME_STATUS_UPDATE IOCTL Ottiene l'impostazione del livello di volume del microfono del dispositivo Bluetooth.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Valore BOOL impostato su TRUE per richiedere un aggiornamento immediato. In caso contrario, impostare su FALSE.

Lunghezza del buffer di input

Dimensioni di un valore BOOL.

Buffer di output

Long che rappresenta il livello di volume del microfono in decibel 1/65536.

Lunghezza del buffer di output

Dimensione di un valore LONG.

Blocco dello stato

Se una richiesta è già in sospeso, la nuova richiesta ha esito negativo e viene restituito un messaggio di STATUS_INVALID_DEVICE_REQUEST.

Commenti

Questa richiesta verrà completata immediatamente se il parametro di input è TRUE o se lo stato del volume è stato modificato dopo l'ultima richiesta. In caso contrario, questa richiesta rimarrà in sospeso fino a quando lo stato del volume non viene modificato o la richiesta viene annullata.

Il driver audio invia questa richiesta per ottenere i livelli iniziale del volume dell'altoparlante e del microfono e invia richieste successive "chiedendo" di essere aggiornate quando i livelli cambiano. Il driver archivia i livelli di volume nei dati di contesto appropriati. Quando il livello del volume cambia, il driver audio genera l'evento KSEVENT_CONTROL_CHANGE per il nodo KSNODETYPE_VOLUME nella topologia KS del percorso dell'altoparlante o del microfono.

Il parametro di output della richiesta corrisponde al valore della proprietà KSPROPERTY_AUDIO_VOLUMELEVEL .