BRB_HEADER-Struktur (bthddi.h)
Die BRB_HEADER-Struktur enthält Headerinformationen 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;
Member
ListEntry
Eine LIST_ENTRY Struktur, die vom aktuellen Besitzer des BRB verwendet wird, um den BRB in einer Warteschlange zu platzieren.
Length
Die Größe des BRB in Bytes, einschließlich der BRB_HEADER-Struktur. Die Funktionen BthAllocateBrb, BthInitializeBrb und BthReuseBrb legen diesen Member automatisch fest.
Version
Nur zur internen Verwendung. Darf nicht verwendet werden.
Type
Der Bluetooth-Anforderungsblocktyp. Die Funktionen BthAllocateBrb, BthInitializeBrb und BthReuseBrb legen diesen Member automatisch fest. 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 zur internen Verwendung. Darf nicht verwendet werden.
Status
Der NTSTATUS-Code, der übergeben wird, wenn der BRB-Aufruf abgeschlossen ist.
BtStatus
Der Bluetooth status Code (BTSTATUS), der dem NTSTATUS-Code entspricht, der im Statuselement ü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 zur internen Verwendung. Darf nicht verwendet werden.
ClientContext[BTHPORT_CONTEXT_SIZE]
Der Clientkontext, der dem BRB-Aufruf zugeordnet ist. Der Aufrufer kann dieses Element verwenden, um einen Zeiger oder andere Informationen zu speichern.
Reserved[BTHPORT_RESERVED_FIELD_SIZE]
Für die zukünftige Verwendung reserviert. Nicht verwenden.
Hinweise
Die BRB_HEADER-Struktur enthält allgemeine Arten von Informationen über den 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Versionen:_Supported in Windows Vista und höher. |
| Kopfzeile | bthddi.h (include Bthddi.h) |