BthSSPIOCapabilityRequestReply (Compact 7)

3/12/2014

This function may be called in response to the BTE_SSP_IO_CAPABILITY_REQUEST event to report the application’s pairing requirements and I/O and out-of-band (OOB) capabilities to a peer Bluetooth device.

Syntax

DWORD BthSSPIOCapabilityRequestReply(
    __in const BT_ADDR              *RemoteDevice,
  __in const BTSSPIOCapability     IOCapability,
  __in const BOOL                  OOBDataPresent,
  __in const BTSSPAuthRequirement *pAuthRequirements);

Parameters

  • RemoteDevice
    [in] Pointer to a Bluetooth address of the peer device.
  • IOCapability
    [in] Input and output capabilities of the device. For flag values see BTSSPIOCapability.
  • OOBDataPresent
    [in] TRUE if the application has OOB pairing data for the peer device.
  • pAuthRequirements
    [in] Pointer to the authorization requirements of the application, a BTSSPAuthRequirement structure.

Return Value

The following table shows the possible return values.

Value Description

ERROR_SUCCESS

Success.

Remarks

The application only receives the BTE_SSP_IO_CAPABILITY_REQUEST event if the Flags member of the BTSSPConfigurationInfo structure passed to BthSSPSetConfigurationInfo included the BT_SSP_FLAG_INDICATE_IO_CAPABILITY_REQUEST_EVENTS flag.

Requirements

Header

bt_api.h

Library

Btdrt.lib

See Also

Reference

Bluetooth API SSP Functions
BthSSPIOCapabilityRequestNegativeReply
BT_SSP_IO_CAPABILITY_RESPONSE_EVENT