BRB_HEADER Struktur (bthddi.h)

Die BRB_HEADER-Struktur enthält Kopfzeileninformationen zu einem Bluetooth-Anforderungsblock (BRB), einschließlich Informationen zum BRB-Typ, den der Bluetooth-Treiberstapel verwendet, um zu bestimmen, welche Art von BRB-Typ verarbeitet werden soll.

Syntax

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;

Angehörige

ListEntry

Eine LIST_ENTRY Struktur, die vom aktuellen Besitzer des BRB zum Platzieren des BRB in einer Warteschlange verwendet wird.

Length

Die Größe des BRB in Bytes, einschließlich der BRB_HEADER-Struktur. Die BthAllocateBrb, BthInitializeBrb und BthReuseBrb Funktionen automatisch festlegen.

Version

Nur für die interne Verwendung. Nicht verwenden.

Type

Der Typ des Bluetooth-Anforderungsblocks. Die BthAllocateBrb, BthInitializeBrb und BthReuseBrb Funktionen automatisch festlegen. Mögliche Werte sind:

• 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

Nur für die interne Verwendung. Nicht verwenden.

Status

Der NTSTATUS-Code, der übergeben wird, wenn der BRB-Aufruf abgeschlossen ist.

BtStatus

Der Bluetooth-Statuscode (BTSTATUS), der dem NTSTATUS-Code entspricht, der im Status Member übergeben wird. Mögliche Werte sind:

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

Nur für die interne Verwendung. Nicht verwenden.

ClientContext[BTHPORT_CONTEXT_SIZE]

Der Clientkontext, der dem BRB-Aufruf zugeordnet ist. Der Aufrufer kann dieses Mitglied verwenden, um einen Zeiger oder andere Informationen zu speichern.

Reserved[BTHPORT_RESERVED_FIELD_SIZE]

Reserviert für die zukünftige Verwendung. Nicht verwenden.

Bemerkungen

Die BRB_HEADER-Struktur enthält allgemeine Informationstypen zum angegebenen BRB. Die BRB_HEADER Struktur wird von allen BRB-Strukturen verwendet, die als Eingabepuffer für IOCTL_INTERNAL_BTH_SUBMIT_BRB IOCTLs.

Profiltreiber sollten keines der Member der BRB_HEADER-Struktur ändern, außer ClientContext-.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Versionen:_Supported in Windows Vista und höher.
Header-	bthddi.h (include Bthddi.h)

Siehe auch

BthAllocateBrb

BthInitializeBrb

BthReuseBrb