IOCTL_BTHHFP_DEVICE_GET_CONNECTION_STATUS_UPDATE IOCTL (bthhfpddi.h)

The IOCTL_BTHHFP_DEVICE_GET_CONNECTION_STATUS_UPDATE IOCTL Gets a connection status update.

Major code

IRP_MJ_DEVICE_CONTROL

Input buffer

A BOOL that is set to TRUE to request an immediate update. Otherwise, set this to FALSE.

Input buffer length

The size of a BOOL.

Output buffer

A BOOL that is the new connection status. TRUE if connected. FALSE if not connected.

Output buffer length

The size of a BOOL.

Status block

If a request is already pending the new request fails and a STATUS_INVALID_DEVICE_REQUEST message is returned.

Remarks

This request will complete immediately if the input parameter is TRUE or if the connection status has changed since the last request. Otherwise this request will remain pending until the connection status changes or the request is cancelled.

The audio driver sends this request to get the initial connection status, and sends subsequent requests to be updated when the status changes. The driver stores the connection status in appropriate context data.

When the request completes and indicates a change in the connection status, the audio driver generates the KSEVENT_PINCAPS_JACKINFOCHANGE KS event.

When handling the KSPROPERTY_JACK_DESCRIPTION KS property, the audio driver sets the IsConnected member of the KSJACK_DESCRIPTION structure based on the connection status.

Requirements

Requirement Value
Minimum supported client Windows 8
Minimum supported server Windows Server 2012
Header bthhfpddi.h

See also

Bluetooth HFP DDI IOCTLs

KSEVENT_PINCAPS_JACKINFOCHANGE

KSJACK_DESCRIPTION

KSPROPERTY_JACK_DESCRIPTION