IOCTL_BTHX_GET_VERSION IOCTL (bthxddi.h)

Profile drivers use IOCTL_BTHX_GET_VERSION to get the version supported by the transport driver.

Major code

IRP_MJ_DEVICE_CONTROL

Input buffer

None.

Input buffer length

None.

Output buffer

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

Status = WdfRequestRetrieveOutputMemory(_Request, &ReqOutMemory);

The buffer describes a BTHX_VERSION structure.

Refer to the WDK Bluetooth samples for more information.

Output buffer length

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

Status block

The Information member of the STATUS_BLOCK structure is set to the size, in bytes, of the buffer that holds the BTHX_VERSION structure.

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_GET_VERSION is a synchronous operation.

A transport driver can return one or more versions that it supports in BTHX_VERSION structure. If no version is set, Windows unloads the Bluetooth stack.

Requirements

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