Edit

IOCTL_BTHX_SET_VERSION IOCTL (bthxddi.h)

  • Article

IOCTL_BTHX_SET_VERSION is used to inform the transport driver of the version of the extensibility interface being used.

Major code

IRP_MJ_DEVICE_CONTROL

Input buffer

Profile drivers should use KMDF and its WdfRequestRetrieveInputMemory method to retrieve input parameters. For example, to get the input buffer:

Status = WdfRequestRetrieveInputMemory(_Request, &ReqInMemory);

The buffer describes a BTHX_VERSION structure.

Refer to the WDK Bluetooth samples for more information.

Input buffer length

The length of the buffer is the size of the BTHX_VERSION structure.

Output buffer

None.

Output buffer length

None.

Status block

The Information member of the STATUS_BLOCK structure is set to zero because the Bluetooth driver stack returns no data with this IOCTL.

The Status member is set to one of the values in the following table.

Status value Description
STATUS_SUCCESS The IOCTL completed successfully.
 

Any unsuccessful NT status code prevents the driver from loading.

Remarks

IOCTL_BTHX_SET_VERSION is a synchronous operation.

Only one version will be selected and set.

Requirements

Requirement Value
Minimum supported client Supported starting with Windows 8.
Header bthxddi.h
IRQL <= PASSIVE_LEVEL