HCI_PARAMETERS (Windows CE 5.0)
This structure is used to define HCI transport interfaces.
typedef struct __hci_parameters {
unsigned int uiSize; unsigned int fInterfaceVersion; int iMaxSizeRead; int iMaxSizeWrite; int iReadBufferHeader; int iReadBufferTrailer; int iWriteBufferHeader; int iWriteBufferTrailer; int uiFlags; int fHardwareVersion; unsigned int uiResetDelay; unsigned int uiWriteTimeout; unsigned int uiDriftFactor; int iScoWriteLowNumPackets; int iScoWriteNumPackets; int iScoWritePacketSize; int iScoSampleSize;} HCI_PARAMETERS;
Members
- uiSize
Structure size. Must be sizeof(HCI_PARAMETERS). - fInterfaceVersion
Interface version. Must be HCI_INTERFACE_VERSION_1_0. This is version of the transport driver, not the underlying hardware. - iMaxSizeRead
Maximum size of the read buffer, not including headers and trailers. This value must at least accommodate the largest HCI command, but may be bigger. Buffer submitted to HCI_ReadPacket will be at least as big. - iMaxSizeWrite
Maximum size of the write packet, not including headers and trailers. This value must accommodate at least the largest HCI command, but must be no bigger than the maximum data packet accepted by transport. The packet given to HCI_WritePacket will be no bigger than this. - iReadBufferHeader
This is a hint value, used to compute (along with iMaxSizeRead and iReadBufferTrailer) maximum size of buffer prepared for HCI_ReadPacket. - iReadBufferTrailer
This is a hint value, used to compute (along with iMaxSizeRead and iReadBufferHeader) maximum size of buffer prepared for HCI_ReadPacket. - iWriteBufferHeader
Number of bytes to preallocate for transport header in HCI_WritePacket at the beginning of the packet (between 0 and BD_BUFFER::cStart). - iWriteBufferTrailer
Number of bytes to preallocate for transport trailer in HCI_WritePacket at the end of the packet (between BD_BUFFER::cEnd and BD_BUFFER::cSize). - uiFlags
These flags specify the HCI Commands that should be disabled. It could be any combination of the following.Flag Value HCI_FLAGS_NORESET 0x00000001. Disables the HCI_Reset command. Setting this flag ensures that the HCI layer does not send this command to the HCI transport layer, after a connection is established between the two layers. HCI_FLAGS_NOLOCALNAME 0x00000002. Disables the HCI_Change_Local_Name command that is used to modify the friendly name of the device. HCI_FLAGS_NOROLESWITCH 0x00000004. Changes the role-switching parameter value for HCI_Create_Connection and HCI_Accept_Connection_Request commands, for a given transport. - fHardwareVersion
Bluetooth specification version of the underlying Bluetooth hardware. Note that this is different from the fInterfaceVersion, which is a version of the transport driver. The Bluetooth specification version can be any of the following.Specification version Value HCI_HARDWARE_VERSION_V_1_0_A 0 HCI_HARDWARE_VERSION_V_1_0_B 1 HCI_HARDWARE_VERSION_V_1_1 2 - uiResetDelay
Amount of time, in milliseconds, between receiving command completion for HCI_Reset command and the next command can be executed. - uiWriteTimeout
Amount of time, in milliseconds, after which the command aborts if the card does not respond with CommandComplete or CommandStatus event. - uiDriftFactor
Amount of time, in milliseconds, for which the clock offset in inquiry data is presumed to be valid. - iScoWriteLowNumPackets
Minimum number of outstanding SCO write packets in backlog (0 - use default). - iScoWriteNumPackets
Maximum number of outstanding SCO write packets in backlog (0 - use default). - iScoWritePacketSize
Size of each SCO packet (0 - use default, -1 - SCO not supported). - iScoSampleSize
Sample size of SCO packet (8 or 16 bits).
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Bt_hcip.h.
See Also
HCI_ReadPacket | HCI_WritePacket | BD_BUFFER
Send Feedback on this topic to the authors