structure BRB_HEADER (bthddi.h)
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 que la pile de pilotes Bluetooth utilise 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
Une 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, du BRB, y compris la structure BRB_HEADER. Les fonctions BthAllocateBrb, BthInitializeBrb et BthReuseBrb définissent automatiquement ce membre.
Version
À usage interne uniquement. Ne pas utiliser.
Type
Type de bloc de requête Bluetooth. Les fonctions BthAllocateBrb, BthInitializeBrb et 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
À usage interne uniquement. Ne pas utiliser.
Status
Code NTSTATUS transmis à la fin de l’appel BRB.
BtStatus
Le code de status Bluetooth (BTSTATUS) qui correspond au code NTSTATUS passé dans le membre Status. Les valeurs possibles incluent :
- 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]
À usage interne uniquement. Ne pas utiliser.
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 un usage futur. Ne pas utiliser.
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 qui sont utilisées comme mémoire tampon d’entrée pour IOCTL_INTERNAL_BTH_SUBMIT_BRB IOCTLs.
Les pilotes de profil ne doivent modifier aucun des membres de la structure BRB_HEADER, à l’exception de ClientContext.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Versions :_Supported dans Windows Vista et versions ultérieures. |
En-tête | bthddi.h (inclure Bthddi.h) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour