INDICATION_PARAMETERS-Struktur (bthddi.h)
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
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.ConfigResponse.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.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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Versionen:_Supported in Windows Vista und höher. |
| Kopfzeile | bthddi.h (include Bthddi.h) |