HCI_PARAMETERS

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;
} 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 which functions of Bluetooth hardware should be disabled. It could be any combination of the following.

  Flag	Value
  HCI_FLAGS_NORESET	0x00000001
  HCI_FLAGS_NOLOCALNAME	0x00000002
  HCI_FLAGS_NOROLESWITCH	0x00000004

• 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.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Bt_hcip.h.

See Also

HCI_ReadPacket | HCI_WritePacket | BD_BUFFER

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.