IOCTL_BTHHFP_DEVICE_GET_CONNECTION_STATUS_UPDATE IOCTL (bthhfpddi.h)

Artículo
08/07/2023

El IOCTL_BTHHFP_DEVICE_GET_CONNECTION_STATUS_UPDATE IOCTL Obtiene una actualización de estado de conexión.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

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 un BOOL.

Búfer de salida

BoOL que es el nuevo estado de conexión. TRUE si está conectado. FALSE si no está conectado.

Longitud del búfer de salida

Tamaño de un BOOL.

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 de conexión ha cambiado desde la última solicitud. De lo contrario, esta solicitud permanecerá pendiente hasta que cambie el estado de conexión o se cancele la solicitud.

El controlador de audio envía esta solicitud para obtener el estado de conexión inicial y envía solicitudes posteriores que se actualizarán cuando cambie el estado. El controlador almacena el estado de conexión en los datos de contexto adecuados.

Cuando la solicitud finaliza e indica un cambio en el estado de conexión, el controlador de audio genera el evento KSEVENT_PINCAPS_JACKINFOCHANGE KS.

Al controlar la propiedad KSPROPERTY_JACK_DESCRIPTION KS, el controlador de audio establece el miembro IsConnected de la estructura de KSJACK_DESCRIPTION en función del estado de conexión.