Partager via


BthReadRemoteExtendedFeatures (Compact 2013)

3/26/2014

This function retrieves the extended Link Manager Protocol (LMP) feature mask for the specified device and page.

Syntax

DWORD BthReadRemoteExtendedFeatures(
    __in  const BT_ADDR  *pba,
    __in  BYTE            PageNumber,
    __out BYTE            LMPFeatures[8]);

Parameters

  • pba
    [in] Points to the address of the device.
  • PageNumber
    [in] The page number from 0x01 through 0xFF. Set to 0x00 to retrieve the standard LMP feature mask.
  • LMP Features
    [out] The Link Manager Protocol feature mask.

    The following table lists the features and their corresponding bits in the mask. For each feature a single bit is specified that is set to 1 if the feature is supported, and set to 0 otherwise. The single exception is the flow control lag, which is coded as a 3-bit field with the least significant bit in byte 2 bit 4, and the most significant bit in byte 2 bit 6.

    The following table shows the page 0 mask.

    No.

    Supported feature

    Byte

    Bit

    0

    3 slot packets

    0

    0

    1

    5 slot packets

    0

    1

    2

    Encryption

    0

    2

    3

    Slot offset

    0

    3

    4

    Timing accuracy

    0

    4

    5

    Role switch

    0

    5

    6

    Hold mode

    0

    6

    7

    Sniff mode

    0

    7

    8

    Park state

    1

    0

    9

    Power control requests

    1

    1

    10

    Channel quality driven data rate (CQDDR)

    1

    2

    11

    SCO link

    1

    3

    12

    HV2 packets

    1

    4

    13

    HV3 packets

    1

    5

    14

    μ-law log synchronous data

    1

    6

    15

    A-law log synchronous data

    1

    7

    16

    CVSD synchronous data

    2

    0

    17

    Paging parameter negotiation

    2

    1

    18

    Power control

    2

    2

    19

    Transparent synchronous data

    2

    3

    20

    Flow control lag (least significant bit)

    2

    4

    21

    Flow control lag (middle bit)

    2

    5

    22

    Flow control lag (most significant bit)

    2

    6

    23

    Broadcast Encryption

    2

    7

    24

    Reserved

    3

    0

    25

    Enhanced Data Rate ACL 2 Mbps mode

    3

    1

    26

    Enhanced Data Rate ACL 3 Mbps mode

    3

    2

    27

    Enhanced inquiry scan

    3

    3

    28

    Interlaced inquiry scan

    3

    4

    29

    Interlaced page scan

    3

    5

    30

    RSSI with inquiry results

    3

    6

    31

    Extended SCO link (EV3 packets)

    3

    7

    32

    EV4 packets

    4

    0

    33

    EV5 packets

    4

    1

    34

    Reserved

    4

    2

    35

    AFH capable subordinate device

    4

    3

    36

    AFH classification subordinate device

    4

    4

    37

    Reserved

    4

    5

    38

    Reserved

    4

    6

    39

    3-slot Enhanced Data Rate ACL packets

    4

    7

    40

    5-slot Enhanced Data Rate ACL packets

    5

    0

    41

    Sniff subrating

    5

    1

    42

    Pause encryption

    5

    2

    43

    AFH capable master device

    5

    3

    44

    AFH classification master device

    5

    4

    45

    Enhanced Data Rate eSCO 2 Mbps mode

    5

    5

    46

    Enhanced Data Rate eSCO 3 Mbps mode

    5

    6

    47

    3-slot Enhanced Data Rate eSCO packets

    5

    7

    48

    Extended Inquiry Response

    6

    0

    51

    Secure Simple Pairing

    6

    3

    52

    Encapsulated PDU

    6

    4

    53

    Erroneous Data Reporting

    6

    5

    54

    Non-flushable Packet Boundary Flag

    6

    6

    56

    Link Supervision Timeout Changed Event

    7

    0

    57

    Inquiry Response TX Power Level

    7

    1

    63

    Extended features

    7

    7

    The following table shows the page 1 mask.

    No.

    Supported feature

    Byte

    Bit

    64

    Secure Simple Pairing (Host Support)

    0

    0

Return Value

The following table shows the possible return values.

Value

Description

ERROR_SUCCESS

Success.

ERROR_SERVICE_NOT_ACTIVE

The Bluetooth stack is not present.

Requirements

Header

bt_api.h

Library

Btdrt.lib

See Also

Reference

Bluetooth API Management Functions