Partager via

structure BRB_HEADER (bthddi.h)

  • Article

La structure BRB_HEADER contient des informations d’en-tête sur un bloc de requête Bluetooth (BRB), y compris des informations sur le type BRB utilisé par la pile des pilotes Bluetooth pour déterminer le type de type BRB à traiter.

Syntaxe

typedef struct _BRB_HEADER {
  LIST_ENTRY ListEntry;
  ULONG      Length;
  USHORT     Version;
  USHORT     Type;
  ULONG      BthportFlags;
  NTSTATUS   Status;
  BTHSTATUS  BtStatus;
  PVOID      Context[BTHPORT_CONTEXT_SIZE];
  PVOID      ClientContext[BTHPORT_CONTEXT_SIZE];
  ULONG      Reserved[BTHPORT_RESERVED_FIELD_SIZE];
} BRB_HEADER;

Membres

ListEntry

Structure LIST_ENTRY utilisée par le propriétaire actuel du BRB pour placer le BRB dans une file d’attente.

Length

Taille, en octets, de la BRB, y compris la structure BRB_HEADER. Les fonctions BthAllocateBrbBthInitializeBrb et fonctions BthReuseBrb définissent automatiquement ce membre.

Version

Pour une utilisation interne uniquement. N’utilisez pas.

Type

Type de bloc de requête Bluetooth. Les fonctions BthAllocateBrbBthInitializeBrb et fonctions BthReuseBrb définissent automatiquement ce membre. Les valeurs possibles sont les suivantes :

  • BRB_HCI_GET_LOCAL_BD_ADDR
  • BRB_L2CA_REGISTER_SERVER
  • BRB_L2CA_UNREGISTER_SERVER
  • BRB_L2CA_OPEN_CHANNEL
  • BRB_L2CA_OPEN_CHANNEL_RESPONSE
  • BRB_L2CA_CLOSE_CHANNEL
  • BRB_L2CA_ACL_TRANSFER
  • BRB_L2CA_UPDATE_CHANNEL
  • BRB_L2CA_PING
  • BRB_REGISTER_PSM
  • BRB_UNREGISTER_PSM
  • BRB_SCO_REGISTER_SERVER
  • BRB_SCO_UNREGISTER_SERVER
  • BRB_SCO_OPEN_CHANNEL
  • BRB_SCO_OPEN_CHANNEL_RESPONSE
  • BRB_SCO_CLOSE_CHANNEL
  • BRB_SCO_TRANSFER
  • BRB_SCO_GET_CHANNEL_INFO
  • BRB_SCO_GET_SYSTEM_INFO
  • BRB_SCO_FLUSH_CHANNEL
  • BRB_ACL_GET_MODE
  • BRB_ACL_ENTER_ACTIVE_MODE
  • BRB_GET_DEVICE_INTERFACE_STRING

BthportFlags

Pour une utilisation interne uniquement. N’utilisez pas.

Status

Code NTSTATUS transmis lorsque l’appel BRB se termine.

BtStatus

Code d’état Bluetooth (BTSTATUS) qui correspond au code NTSTATUS passé dans le membre Status. Les valeurs possibles sont les suivantes :

  • BTH_ERROR_SUCCESS
  • BTH_ERROR_ACL_CONNECTION_ALREADY_EXISTS
  • BTH_ERROR_AUTHENTICATION_FAILURE
  • BTH_ERROR_COMMAND_DISALLOWED
  • BTH_ERROR_CONNECTION_TIMEOUT
  • BTH_ERROR_ENCRYPTION_MODE_NOT_ACCEPTABLE
  • BTH_ERROR_HARDWARE_FAILURE
  • BTH_ERROR_HOST_REJECTED_LIMITED_RESOURCES
  • BTH_ERROR_HOST_REJECTED_PERSONAL_DEVICE
  • BTH_ERROR_HOST_REJECTED_SECURITY_REASONS
  • BTH_ERROR_HOST_TIMEOUT
  • BTH_ERROR_INSTANT_PASSED
  • BTH_ERROR_INVALID_HCI_PARAMETER
  • BTH_ERROR_INVALID_LMP_PARAMETERS
  • BTH_ERROR_KEY_MISSING
  • BTH_ERROR_LMP_PDU_NOT_ALLOWED
  • BTH_ERROR_LMP_RESPONSE_TIMEOUT
  • BTH_ERROR_LMP_TRANSACTION_COLLISION
  • BTH_ERROR_LOCAL_HOST_TERMINATED_CONNECTION
  • BTH_ERROR_MAX_NUMBER_OF_CONNECTIONS
  • BTH_ERROR_MAX_NUMBER_OF_SCO_CONNECTIONS
  • BTH_ERROR_MEMORY_FULL
  • BTH_ERROR_NO_CONNECTION
  • BTH_ERROR_PAGE_TIMEOUT
  • BTH_ERROR_PAIRING_NOT_ALLOWED
  • BTH_ERROR_PAIRING_WITH_UNIT_KEY_NOT_SUPPORTED
  • BTH_ERROR_QOS_IS_NOT_SUPPORTED
  • BTH_ERROR_REMOTE_LOW_RESOURCES
  • BTH_ERROR_REMOTE_POWERING_OFF
  • BTH_ERROR_REMOTE_USER_ENDED_CONNECTION
  • BTH_ERROR_REPEATED_ATTEMPTS
  • BTH_ERROR_ROLE_CHANGE_NOT_ALLOWED
  • BTH_ERROR_SCO_AIRMODE_REJECTED
  • BTH_ERROR_SCO_INTERVAL_REJECTED
  • BTH_ERROR_SCO_OFFSET_REJECTED
  • BTH_ERROR_UKNOWN_LMP_PDU
  • BTH_ERROR_UNIT_KEY_NOT_USED
  • BTH_ERROR_UNKNOWN_HCI_COMMAND
  • BTH_ERROR_UNSPECIFIED_ERROR
  • BTH_ERROR_UNSUPPORTED_FEATURE_OR_PARAMETER
  • BTH_ERROR_UNSUPPORTED_LMP_PARM_VALUE
  • BTH_ERROR_UNSUPPORTED_REMOTE_FEATURE

Context[BTHPORT_CONTEXT_SIZE]

Pour une utilisation interne uniquement. N’utilisez pas.

ClientContext[BTHPORT_CONTEXT_SIZE]

Contexte client associé à l’appel BRB. L’appelant peut utiliser ce membre pour stocker un pointeur ou d’autres informations.

Reserved[BTHPORT_RESERVED_FIELD_SIZE]

Réservé pour une utilisation ultérieure. N’utilisez pas.

Remarques

La structure BRB_HEADER contient des types d’informations courants sur le BRB spécifié. La structure BRB_HEADER est utilisée par toutes les structures BRB utilisées comme mémoire tampon d’entrée pour IOCTL_INTERNAL_BTH_SUBMIT_BRB IOCTLs.

Les pilotes de profil ne doivent pas modifier les membres de la structure BRB_HEADER, sauf ClientContext.

Exigences

Exigence Valeur
client minimum pris en charge Versions :_Supported dans Windows Vista et versions ultérieures.
d’en-tête bthddi.h (include Bthddi.h)

Voir aussi

BthAllocateBrb

BthInitializeBrb

BthReuseBrb