BT_SSP_IO_CAPABILITY_RESPONSE_EVENT (Compact 7)

3/12/2014

This structure contains event data for the BT_SSP_IO_CAPABILITY_RESPONSE event.

Syntax

typedef struct BT_SSP_IO_CAPABILITY_RESPONSE_EVENT {
    BTSSPIOCapability    IOCapability;
    BOOL                 OOBDataPresent;
    BTSSPAuthRequirement AuthRequirement;
} BT_SSP_IO_CAPABILITY_RESPONSE_EVENT;

Members

  • IOCapability
    Indicates the I/O capabilities of the remote Bluetooth device. For values see BTSSPIOCapability.
  • OOBDataPresent
    TRUE if out-of-band (OOB) data is present on the remote device.
  • AuthRequirement
    Authentication requirements for this pairing. For details see BTSSPAuthRequirement.

Remarks

The event associated with this structure, BTE_SSP_IO_CAPABILITY_RESPONSE, is informative only; no action is required from the application upon reception of this event. You can use the data in this structure to determine whether the Just Works SSP procedure will be used for this pairing.

This structure is the IOCapabilityResponse member of the BTSSPEvent structure. It is present in the union in BTSSPEvent when BTSSPEvent.BTECode is set to BTE_SSP_IO_CAPABILITY_RESPONSE.

Example

The following code shows how to access this structure.

Important

For readability, the following code example does not contain security checking or error handling. Do not use the following code in a production environment.

BTEVENT event;
// Insert code to retrieve event from message queue.
ASSERT(event.dwEventId == BTE_SSP_IO_CAPABILITY_RESPONSE);
BTSSPEvent *pSSPEventData = (BTSSPEvent *) event.baEventData;
BT_SSP_IO_CAPABILITY_RESPONSE_EVENT ioCapEventData =
  pSSPEventData->IOCapabilityResponse;

Requirements

Header

bt_api.h

See Also

Reference

Bluetooth Application Development Structures
RequestBluetoothNotifications
StopBluetoothNotifications
Bluetooth Application Development Events