Freigeben über


INDICATION_PARAMETERS_ENHANCED Struktur (bthddi.h)

Die INDICATION_PARAMETERS_ENHANCED Struktur wird als Parameter an die erweiterten L2CAP Callback Function 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;

Angehörige

ConnectionHandle

Das L2CAP-Verbindungshandle mit dem Remotegerät. Dieses Handle gilt nur für Benachrichtigungen, die über eine bestehende L2CAP-Verbindung eingehen.

BtAddress

Die Bluetooth-Adresse des Remotegeräts.

Parameters

Parameters.Connect

Die Struktur, die Parameter für die IndicationRemoteConnect- Rückruffunktion 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 wert IndicationRemoteConnect INDICATION_CODE in der 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 sich jetzt im Prozess der Konfiguration befindet. Dieses Element 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. Dieses Element 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 den Status der Konfigurationsanforderung angibt. Gültige Kennzeichenwerte werden in der folgenden Tabelle aufgeführt.

Flagge Beschreibung
CONFIG_STATUS_SUCCESS Die Konfigurationsanforderung war erfolgreich.
CONFIG_STATUS_DISCONNECT Fehler bei der Konfigurationsanforderung, da die erweiterte L2CAP-Verbindung getrennt wurde.
CONFIG_STATUS_INVALID_PARAMETER Fehler bei der Konfigurationsanforderung, da ein ungültiger Parameter an den Profiltreiber übergeben wurde.
CONFIG_STATUS_REJECT Der Profiltreiber hat die Konfigurationsanforderung abgelehnt.
CONFIG_STATUS_UNKNOWN_OPTION Fehler bei der Konfigurationsanforderung, da eine der angegebenen Konfigurationsoptionen vom Profiltreiber nicht erkannt wurde.

Parameters.ConfigResponse

Die Struktur, die Parameter für den wert IndicationRemoteConfigResponse INDICATION_CODE 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 sich jetzt im Prozess der Konfiguration befindet. Dieses Element 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. Dieses Element wird verwendet, wenn die Rückruffunktion den wert IndicationRemoteConfigRequest INDICATION_CODE angibt.

Parameters.ConfigResponse.RejectedParams

Eine CHANNEL_CONFIG_PARAMETERS_ENHANCED Struktur, die die Vom Remotegerät abgelehnten Konfigurationsparametereinstellungen enthält.

Parameters.ConfigResponse.UnknownTypes

Ein Array von Typen, die vom Antwortgerät nicht erkannt wurden.

Parameters.ConfigResponse.NumUnknownTypes

Die Anzahl der nicht erkannten 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 den Status der Konfigurationsanforderung angibt. Gültige Kennzeichenwerte sind in der folgenden Tabelle aufgeführt:

Flagge Beschreibung
CONFIG_STATUS_SUCCESS Die Konfigurationsanforderung war erfolgreich.
CONFIG_STATUS_DISCONNECT Fehler bei der Konfigurationsanforderung, da die erweiterte L2CAP-Verbindung getrennt wurde.
CONFIG_STATUS_INVALID_PARAMETER Fehler bei der Konfigurationsanforderung, da ein ungültiger Parameter an den Profiltreiber übergeben wurde.
CONFIG_STATUS_REJECT Der Profiltreiber hat die Konfigurationsanforderung abgelehnt.
CONFIG_STATUS_UNKNOWN_OPTION Fehler bei der Konfigurationsanforderung, da eine der angegebenen Konfigurationsoptionen vom Profiltreiber nicht erkannt wurde.

Parameters.FreeExtraOptions

Die Struktur, die Parameter für den wert IndicationFreeExtraOptions INDICATION_CODE enthält.

Parameters.FreeExtraOptions.NumExtraOptions

Die Anzahl der zusätzlichen Optionen, die im ExtraOptions Member enthalten sind.

Parameters.FreeExtraOptions.ExtraOptions

Zusätzliche Optionen.

Parameters.Disconnect

Die Struktur, die die Parameter für den wert IndicationRemoteDisconnect INDICATION_CODE 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 zum Benachrichtigen des Bluetooth-Treiberstapels verwendet, 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 den Wert auf FALSE- fest, um die Verbindung geöffnet zu halten.

Parameters.RecvPacket

Die Struktur, die die Parameter für den wert IndicationRecvPacket INDICATION_CODE enthält.

Parameters.RecvPacket.PacketLength

Die Größe des Pakets, das von der Rückruffunktion über die L2CAP-Verbindung gesendet wurde.

Parameters.RecvPacket.TotalQueueLength

Die Anzahl der Pakete, die über die L2CAP-Verbindung verarbeitet werden sollen.

Parameters.Reserved

Reserviertes Mitglied. Nicht verwenden.

Anforderungen

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