INDICATION_PARAMETERS Struktur (bthddi.h)
Die INDICATION_PARAMETERS Struktur wird als Parameter Parameter an die L2CAP Callback Function 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;
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 IndicationRemoteConnectINDICATION_CODE Wert im parameter Indication 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 sich jetzt im Prozess der Konfiguration befindet. Dieses Element 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. Dieses Element 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 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 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 IndicationRemoteConfigResponseINDICATION_CODE Wert enthält.
Parameters.ConfigResponse.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 sich jetzt im Prozess der Konfiguration befindet. Dieses Element wird verwendet, wenn die Rückruffunktion den IndicationRemoteConfigRequestINDICATION_CODE Wert angibt.
Parameters.ConfigResponse.RequestedParams
Eine CHANNEL_CONFIG_PARAMETERS Struktur, die die Parameter enthält, die vom Remotehost für Konfigurationsanforderungen übergeben werden. Dieses Element wird verwendet, wenn die Rückruffunktion den IndicationRemoteConfigRequestINDICATION_CODE Wert angibt.
Parameters.ConfigResponse.RejectedParams
A *CHANNEL_CONFIG_PARAMETERS Struktur, die die Konfigurationsparametereinstellungen enthält, die vom Remotegerät abgelehnt wurden.
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
A *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 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 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 IndicationFreeExtraOptionsINDICATION_CODE Wert enthält.
Parameters.FreeExtraOptions.NumExtraOptions
Die Anzahl der zusätzlichen Optionen, die im ExtraOptions Member enthalten sind.
Parameters.FreeExtraOptions.ExtraOptions
Die Anzahl der zusätzlichen Optionen, die im ExtraOptions Member enthalten sind.
Parameters.Disconnect
Die Struktur, die die Parameter für den wert IndicationRemoteDisconnectINDICATION_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 IndicationRecvPacketINDICATION_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.
Bemerkungen
Die L2CAP-Rückruffunktion eines Profiltreibers sollte diese Struktur je nach dem Wert, den der Bluetooth-Treiberstapel übergibt, in den parameter Indication Parameter der Rückruffunktion unterschiedlich verarbeiten.
Wenn der Bluetooth-Treiberstapel IndicationRemoteConnect-übergibt, sollte die Rückruffunktion das Connect Mitglied der Parameters Union verwenden.
Wenn der Bluetooth-Treiberstapel IndicationRemoteDisconnectübergibt, sollte die Rückruffunktion das Disconnect Member der Parameters Union verwenden.
Wenn der Bluetooth-Treiberstapel IndicationRemoteConfigRequestübergibt, sollte die Rückruffunktion das ConfigRequest Mitglied der Parameters Union verwenden.
Wenn der Bluetooth-Treiberstapel IndicationRemoteConfigResponseübergibt, sollte die Rückruffunktion das ConfigResponse Member der Parameters Union verwenden.
Wenn der Bluetooth-Treiberstapel IndicationRemoteFreeExtraOptionsübergibt, sollte die Rückruffunktion das FreeExtraOptions- element der Parameters Union verwenden.
Wenn der Bluetooth-Treiberstapel IndicationRemoteRecvPacketübergibt, sollte die Rückruffunktion das RecvPacket Member der Parameters Union verwenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Versionen:_Supported in Windows Vista und höher. |
| Header- | bthddi.h (include Bthddi.h) |