INDICATION_PARAMETERS_ENHANCED-Struktur (bthddi.h)
Die INDICATION_PARAMETERS_ENHANCED-Struktur wird als Parameterparameter an die erweiterte L2CAP-Rückruffunktion eines Profiltreibers übergeben.
Syntax
typedef struct _INDICATION_PARAMETERS_ENHANCED {
L2CAP_CHANNEL_HANDLE ConnectionHandle;
IN BTH_ADDR BtAddress;
union {
struct {
struct {
OUT USHORT PSM;
} Request;
} Connect;
struct {
CHANNEL_CONFIG_PARAMETERS_ENHANCED CurrentParams;
CHANNEL_CONFIG_PARAMETERS_ENHANCED RequestedParams;
CHANNEL_CONFIG_PARAMETERS_ENHANCED ResponseParams;
USHORT Response;
} ConfigRequest;
struct {
CHANNEL_CONFIG_PARAMETERS_ENHANCED CurrentParams;
CHANNEL_CONFIG_PARAMETERS_ENHANCED RequestedParams;
CHANNEL_CONFIG_PARAMETERS_ENHANCED RejectedParams;
PCO_TYPE UnknownTypes;
ULONG NumUnknownTypes;
CHANNEL_CONFIG_PARAMETERS_ENHANCED NewRequestParams;
USHORT Response;
} ConfigResponse;
struct {
ULONG NumExtraOptions;
PL2CAP_CONFIG_OPTION ExtraOptions;
} FreeExtraOptions;
struct {
L2CAP_DISCONNECT_REASON Reason;
BOOLEAN CloseNow;
} Disconnect;
struct {
ULONG PacketLength;
ULONG TotalQueueLength;
} RecvPacket;
PVOID Reserved;
} Parameters;
} *PINDICATION_PARAMETERS_ENHANCED, INDICATION_PARAMETERS_ENHANCED;
Member
ConnectionHandle
Das L2CAP-Verbindungshandle zum Remotegerät. Dieses Handle gilt nur für Benachrichtigungen, die über eine hergestellte L2CAP-Verbindung eingehen.
BtAddress
Die Bluetooth-Adresse des Remotegeräts.
Parameters
Parameters.Connect
Die Struktur, die Parameter für die Rückruffunktion IndicationRemoteConnect enthält.
Parameters.Connect.Request
Die Struktur, die die Parameter für eine Verbindungsanforderung enthält.
Parameters.Connect.Request.PSM
Der Protocol/Service Multiplexer (PSM), der an die aufrufende Funktion übergeben wird, wenn der IndicationRemoteConnect INDICATION_CODE Wert im Indication-Parameter der erweiterten Rückruffunktion angegeben wird.
Parameters.ConfigRequest
Die -Struktur, die Parameter für den Wert "IndicationRemoteConfigRequest" INDICATION_CODE enthält.
Parameters.ConfigRequest.CurrentParams
Eine CHANNEL_CONFIG_PARAMETERS_ENHANCED-Struktur , die die Parameter für den aktuellen Kanal enthält. Dieser Wert ist nur gültig, wenn der Kanal zuvor geöffnet war und jetzt konfiguriert wird. Dieser Member wird verwendet, wenn die Rückruffunktion den Wert indicationRemoteConfigRequest INDICATION_CODE angibt.
Parameters.ConfigRequest.RequestedParams
Eine CHANNEL_CONFIG_PARAMETERS_ENHANCED-Struktur, die die Parameter enthält, die vom Remotehost für Konfigurationsanforderungen übergeben werden. Dieser Member wird verwendet, wenn die Rückruffunktion den Wert indicationRemoteConfigRequest INDICATION_CODE angibt.
Parameters.ConfigRequest.ResponseParams
Eine CHANNEL_CONFIG_PARAMETERS_ENHANCED-Struktur, die die Parameter enthält, mit denen der Profiltreiber auf die Konfigurationsanforderung antwortet.
Parameters.ConfigRequest.Response
Ein Flag, das die status der Konfigurationsanforderung angibt. Gültige Flagwerte sind in der folgenden Tabelle aufgeführt.
| Flag | Beschreibung |
|---|---|
| CONFIG_STATUS_SUCCESS | Die Konfigurationsanforderung war erfolgreich. |
| CONFIG_STATUS_DISCONNECT | Bei der Konfigurationsanforderung ist ein Fehler aufgetreten, weil die verbindung mit der erweiterten L2CAP-Verbindung getrennt wurde. |
| CONFIG_STATUS_INVALID_PARAMETER | Die Konfigurationsanforderung ist fehlgeschlagen, weil ein ungültiger Parameter an den Profiltreiber übergeben wurde. |
| CONFIG_STATUS_REJECT | Der Profiltreiber hat die Konfigurationsanforderung abgelehnt. |
| CONFIG_STATUS_UNKNOWN_OPTION | Die Konfigurationsanforderung ist fehlgeschlagen, weil eine der angegebenen Konfigurationsoptionen vom Profiltreiber nicht erkannt wurde. |
Parameters.ConfigResponse
Die Struktur, die Parameter für den IndicationRemoteConfigResponse INDICATION_CODE Wert enthält.
Parameters.ConfigResponse.CurrentParams
Eine CHANNEL_CONFIG_PARAMETERS_ENHANCED-Struktur , die die Parameter für den aktuellen Kanal enthält.
Dieser Wert ist nur gültig, wenn der Kanal zuvor geöffnet war und jetzt konfiguriert wird. Dieser Member wird verwendet, wenn die Rückruffunktion den Wert indicationRemoteConfigRequest INDICATION_CODE angibt.
Parameters.ConfigResponse.RequestedParams
Eine CHANNEL_CONFIG_PARAMETERS_ENHANCED-Struktur, die die Parameter enthält, die vom Remotehost für Konfigurationsanforderungen übergeben werden. Dieser Member wird verwendet, wenn die Rückruffunktion den Wert indicationRemoteConfigRequest INDICATION_CODE angibt.
Parameters.ConfigResponse.RejectedParams
Eine CHANNEL_CONFIG_PARAMETERS_ENHANCED-Struktur, die die Konfigurationsparametereinstellungen enthält, die vom Remotegerät abgelehnt wurden.
Parameters.ConfigResponse.UnknownTypes
Ein Array von Typen, die vom antwortend-Gerät nicht erkannt wurden.
Parameters.ConfigResponse.NumUnknownTypes
Die Anzahl der unbekannten Typen im UnknownTypes-Member .
Parameters.ConfigResponse.NewRequestParams
Eine CHANNEL_CONFIG_PARAMETERS_ENHANCED Struktur, die die Parametereinstellungen für die erweiterte Rückruffunktion enthält, die erneut übermittelt werden soll, nachdem die Antwort vom Remotegerät zurückgegeben wurde.
Parameters.ConfigResponse.Response
Ein Flag, das die status der Konfigurationsanforderung angibt. Gültige Flagwerte sind in der folgenden Tabelle aufgeführt:
| Flag | Beschreibung |
|---|---|
| CONFIG_STATUS_SUCCESS | Die Konfigurationsanforderung war erfolgreich. |
| CONFIG_STATUS_DISCONNECT | Bei der Konfigurationsanforderung ist ein Fehler aufgetreten, weil die verbindung mit der erweiterten L2CAP-Verbindung getrennt wurde. |
| CONFIG_STATUS_INVALID_PARAMETER | Die Konfigurationsanforderung ist fehlgeschlagen, weil ein ungültiger Parameter an den Profiltreiber übergeben wurde. |
| CONFIG_STATUS_REJECT | Der Profiltreiber hat die Konfigurationsanforderung abgelehnt. |
| CONFIG_STATUS_UNKNOWN_OPTION | Die Konfigurationsanforderung ist fehlgeschlagen, weil eine der angegebenen Konfigurationsoptionen vom Profiltreiber nicht erkannt wurde. |
Parameters.FreeExtraOptions
Die Struktur, die Parameter für den IndicationFreeExtraOptions INDICATION_CODE Wert enthält.
Parameters.FreeExtraOptions.NumExtraOptions
Die Anzahl der zusätzlichen Optionen, die im ExtraOptions-Element enthalten sind.
Parameters.FreeExtraOptions.ExtraOptions
Zusätzliche Optionen.
Parameters.Disconnect
Die Struktur, die die Parameter für den IndicationRemoteDisconnect INDICATION_CODE Wert enthält.
Parameters.Disconnect.Reason
Ein L2CAP_DISCONNECT_REASON Wert, der angibt, warum die L2CAP-Verbindung mit dem Remotegerät beendet wurde.
Parameters.Disconnect.CloseNow
Ein boolescher Wert, den ein Profiltreiber verwendet, um den Bluetooth-Treiberstapel zu benachrichtigen, um die L2CAP-Verbindung zu schließen. Legen Sie dieses Element auf TRUE fest, um den Bluetooth-Treiberstapel zu benachrichtigen, um die Verbindung zu schließen. Legen Sie andernfalls auf FALSE fest, um die Verbindung offen zu halten.
Parameters.RecvPacket
Die Struktur, die die Parameter für den IndicationRecvPacket INDICATION_CODE Wert enthält.
Parameters.RecvPacket.PacketLength
Die Größe des Pakets in Bytes, das die Rückruffunktion über die L2CAP-Verbindung gesendet hat.
Parameters.RecvPacket.TotalQueueLength
Die Anzahl der Pakete, die über die L2CAP-Verbindung verarbeitet werden sollen.
Parameters.Reserved
Reserviertes Mitglied. Nicht verwenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Versionen:_Supported in Windows 8 und höheren Versionen von Windows |
| Kopfzeile | bthddi.h (include Bthddi.h) |
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für