IOCTL_BTHX_GET_VERSION control code

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

Input Parameters

None.

Output Parameters

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. The length of the buffer is the size of the BTHX_VERSION structure.

Refer to the WDK Bluetooth samples for more information.

I/O 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 valueDescription

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

Version

Supported starting with Windows 8.

Header

BthXDDI.h

IRQL

<= PASSIVE_LEVEL

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft