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)