IOCTL_BTHHFP_DEVICE_GET_CONNECTION_STATUS_UPDATE IOCTL (bthhfpddi.h)

Articolo
03/08/2023

L'IOCTL_BTHHFP_DEVICE_GET_CONNECTION_STATUS_UPDATE IOCTL Ottiene un aggiornamento dello stato della connessione.

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

Valore BOOL che rappresenta il nuovo stato della connessione. TRUE se connesso. FALSE se non è connesso.

Lunghezza del buffer di output

Dimensioni di un valore BOOL.

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 della connessione è stato modificato dopo l'ultima richiesta. In caso contrario, la richiesta rimarrà in sospeso fino a quando lo stato della connessione non viene modificato o la richiesta viene annullata.

Il driver audio invia questa richiesta per ottenere lo stato iniziale della connessione e invia richieste successive da aggiornare quando lo stato cambia. Il driver archivia lo stato della connessione nei dati di contesto appropriati.

Al termine della richiesta e indica una modifica dello stato della connessione, il driver audio genera l'evento KSEVENT_PINCAPS_JACKINFOCHANGE KS.

Quando si gestisce la proprietà KSPROPERTY_JACK_DESCRIPTION KS, il driver audio imposta il membro IsConnected della struttura KSJACK_DESCRIPTION in base allo stato della connessione.