INDICATION_PARAMETERS-Struktur (bthddi.h)

Artikel
02/22/2024

Die INDICATION_PARAMETERS-Struktur wird als Parameterparameter an die L2CAP-Rückruffunktion eines Profiltreibers übergeben.

Syntax

typedef struct _INDICATION_PARAMETERS {
  L2CAP_CHANNEL_HANDLE ConnectionHandle;
  IN BTH_ADDR          BtAddress;
  union {
    struct {
      struct {
        OUT USHORT PSM;
      } Request;
    } Connect;
    struct {
      CHANNEL_CONFIG_PARAMETERS CurrentParams;
      CHANNEL_CONFIG_PARAMETERS RequestedParams;
      CHANNEL_CONFIG_PARAMETERS ResponseParams;
      USHORT                    Response;
    } ConfigRequest;
    struct {
      CHANNEL_CONFIG_PARAMETERS CurrentParams;
      CHANNEL_CONFIG_PARAMETERS RequestedParams;
      CHANNEL_CONFIG_PARAMETERS RejectedParams;
      PCO_TYPE                  UnknownTypes;
      ULONG                     NumUnknownTypes;
      CHANNEL_CONFIG_PARAMETERS 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;
  } Parameters;
} *PINDICATION_PARAMETERS, INDICATION_PARAMETERS;

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 Protokoll-/Dienst multiplexer (PSM), der an die aufrufende Funktion übergeben wird, wenn der wert der IndicationRemoteConnectINDICATION_CODE im Indication-Parameter der Rückruffunktion angegeben wird.

Parameters.ConfigRequest

Die -Struktur, die Parameter für den IndicationRemoteConfigRequestINDICATION_CODE-Wert enthält.

Parameters.ConfigRequest.CurrentParams

Eine CHANNEL_CONFIG_PARAMETERS-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 IndicationRemoteConfigRequestINDICATION_CODE Wert angibt.

Parameters.ConfigRequest.RequestedParams

Eine CHANNEL_CONFIG_PARAMETERS-Struktur , die die Parameter enthält, die vom Remotehost für Konfigurationsanforderungen übergeben werden. Dieser Member wird verwendet, wenn die Rückruffunktion den IndicationRemoteConfigRequestINDICATION_CODE Wert angibt.

Parameters.ConfigRequest.ResponseParams

Eine CHANNEL_CONFIG_PARAMETERS-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	Die Konfigurationsanforderung ist fehlgeschlagen, weil die 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 IndicationRemoteConfigResponseINDICATION_CODE-Wert enthält.

Parameters.ConfigResponse.CurrentParams

Parameters.ConfigResponse.RequestedParams

Parameters.ConfigResponse.RejectedParams

Eine *CHANNEL_CONFIG_PARAMETERS-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-Struktur , die die Parametereinstellungen für die 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	Die Konfigurationsanforderung ist fehlgeschlagen, weil die 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 IndicationFreeExtraOptionsINDICATION_CODE-Wert enthält.

Parameters.FreeExtraOptions.NumExtraOptions

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

Parameters.FreeExtraOptions.ExtraOptions

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

Parameters.Disconnect

Die Struktur, die die Parameter für den IndicationRemoteDisconnectINDICATION_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 IndicationRecvPacketINDICATION_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.

Hinweise

Die L2CAP-Rückruffunktion eines Profiltreibers sollte diese Struktur abhängig vom Wert, den der Bluetooth-Treiberstapel im Parameter Indication der Rückruffunktion übergibt, unterschiedlich verarbeiten.

Wenn der Bluetooth-Treiberstapel IndicationRemoteConnect übergibt, sollte die Rückruffunktion den Connect-Member der Parameterunion verwenden.
Wenn der Bluetooth-Treiberstapel IndicationRemoteDisconnect übergibt, sollte die Rückruffunktion den Disconnect-Member der Parameterunion verwenden.
Wenn der Bluetooth-Treiberstapel IndicationRemoteConfigRequest übergibt, sollte die Rückruffunktion das ConfigRequest-Element der Parameterunion verwenden.
Wenn der Bluetooth-Treiberstapel IndicationRemoteConfigResponse übergibt, sollte die Rückruffunktion den ConfigResponse-Member der Parameterunion verwenden.
Wenn der Bluetooth-Treiberstapel IndicationRemoteFreeExtraOptions übergibt, sollte die Rückruffunktion den FreeExtraOptions-Member der Parameterunion verwenden.
Wenn der Bluetooth-Treiberstapel IndicationRemoteRecvPacket übergibt, sollte die Rückruffunktion den RecvPacket-Member der Parameterunion verwenden.