estructura BRB_HEADER (bthddi.h)

La estructura BRB_HEADER contiene información de encabezado sobre un bloque de solicitud Bluetooth (BRB), incluida la información sobre el tipo BRB que usa la pila del controlador Bluetooth para determinar qué tipo de BRB se va a procesar.

Sintaxis

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;

Miembros

ListEntry

Estructura de LIST_ENTRY usada por el propietario actual del BRB para colocar el BRB en una cola.

Length

Tamaño, en bytes, del BRB, incluida la estructura BRB_HEADER. Las funciones de BthAllocateBrb, BthInitializeBrb y BthReuseBrb establecen automáticamente este miembro.

Version

Solo para uso interno. No use.

Type

Tipo de bloque de solicitud Bluetooth. Las funciones de BthAllocateBrb, BthInitializeBrb y BthReuseBrb establecen automáticamente este miembro. Entre los valores posibles se incluyen:

  • 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

Solo para uso interno. No use.

Status

Código NTSTATUS que se pasa cuando se completa la llamada a BRB.

BtStatus

El código de estado bluetooth (BTSTATUS) que corresponde al código NTSTATUS que se pasa en el miembro Status. Entre los valores posibles se incluyen:

  • 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]

Solo para uso interno. No use.

ClientContext[BTHPORT_CONTEXT_SIZE]

Contexto de cliente asociado a la llamada BRB. El autor de la llamada puede usar este miembro para almacenar un puntero u otra información.

Reserved[BTHPORT_RESERVED_FIELD_SIZE]

Reservado para uso futuro. No use.

Observaciones

La estructura BRB_HEADER contiene tipos comunes de información sobre el BRB especificado. La estructura BRB_HEADER se usa en todas las estructuras BRB que se usan como búfer de entrada para IOCTL_INTERNAL_BTH_SUBMIT_BRB IOCTLs.

Los controladores de perfil no deben modificar ninguno de los miembros de la estructura de BRB_HEADER excepto ClientContext.

Requisitos

Requisito Valor
cliente mínimo admitido Versiones: _Supported en Windows Vista y versiones posteriores.
encabezado de bthddi.h (incluya Bthddi.h)

Consulte también

BthAllocateBrb

BthInitializeBrb

BthReuseBrb

  • Last updated on