Condividi tramite


struttura INDICATION_PARAMETERS_ENHANCED (bthddi.h)

La struttura INDICATION_PARAMETERS_ENHANCED viene passata come parametro Parameters alla funzione di callback L2CAP avanzata del driver di profilo

Sintassi

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;

Members

ConnectionHandle

Handle di connessione L2CAP al dispositivo remoto. Questo handle è valido solo per le notifiche che arrivano su una connessione L2CAP stabilita.

BtAddress

Indirizzo Bluetooth del dispositivo remoto.

Parameters

Parameters.Connect

Struttura che contiene parametri per la funzione di callback IndicationRemoteConnect .

Parameters.Connect.Request

Struttura che contiene i parametri per una richiesta di connessione.

Parameters.Connect.Request.PSM

Protocollo/servizio Multiplexer (PSM) passato alla funzione chiamante quando il valore di INDICATION_CODE IndicationRemoteConnect viene specificato nel parametro Indication della funzione di callback avanzato.

Parameters.ConfigRequest

Struttura che contiene i parametri per il valore di INDICATION_CODE IndicationRemoteConfigRequest .

Parameters.ConfigRequest.CurrentParams

Struttura CHANNEL_CONFIG_PARAMETERS_ENHANCED che contiene i parametri per il canale corrente. Questo valore è valido solo se il canale è stato aperto in precedenza ed è ora in fase di configurazione. Questo membro viene usato quando la funzione di callback specifica il valore di IndicationRemoteConfigRequest INDICATION_CODE.

Parameters.ConfigRequest.RequestedParams

Struttura CHANNEL_CONFIG_PARAMETERS_ENHANCED che contiene i parametri passati dall'host remoto per le richieste di configurazione. Questo membro viene usato quando la funzione di callback specifica il valore di IndicationRemoteConfigRequest INDICATION_CODE.

Parameters.ConfigRequest.ResponseParams

Struttura CHANNEL_CONFIG_PARAMETERS_ENHANCED che contiene i parametri con cui il driver del profilo risponde alla richiesta di configurazione.

Parameters.ConfigRequest.Response

Flag che indica lo stato della richiesta di configurazione. I valori di flag validi sono elencati nella tabella seguente.

Flag Descrizione
CONFIG_STATUS_SUCCESS La richiesta di configurazione ha avuto esito positivo.
CONFIG_STATUS_DISCONNECT La richiesta di configurazione non è riuscita perché la connessione L2CAP avanzata è stata disconnessa.
CONFIG_STATUS_INVALID_PARAMETER La richiesta di configurazione non è riuscita perché un parametro non valido è stato passato al driver del profilo.
CONFIG_STATUS_REJECT Il driver del profilo ha rifiutato la richiesta di configurazione.
CONFIG_STATUS_UNKNOWN_OPTION La richiesta di configurazione non è riuscita perché una delle opzioni di configurazione specificate non è stata riconosciuta dal driver del profilo.

Parameters.ConfigResponse

Struttura che contiene parametri per il valore di IndicationRemoteConfigResponse INDICATION_CODE.

Parameters.ConfigResponse.CurrentParams

Struttura CHANNEL_CONFIG_PARAMETERS_ENHANCED che contiene i parametri per il canale corrente.

Questo valore è valido solo se il canale è stato aperto in precedenza ed è ora in fase di configurazione. Questo membro viene usato quando la funzione di callback specifica il valore di IndicationRemoteConfigRequest INDICATION_CODE.

Parameters.ConfigResponse.RequestedParams

Struttura CHANNEL_CONFIG_PARAMETERS_ENHANCED che contiene i parametri passati dall'host remoto per le richieste di configurazione. Questo membro viene usato quando la funzione di callback specifica il valore di IndicationRemoteConfigRequest INDICATION_CODE.

Parameters.ConfigResponse.RejectedParams

Struttura CHANNEL_CONFIG_PARAMETERS_ENHANCED che contiene le impostazioni dei parametri di configurazione rifiutate dal dispositivo remoto.

Parameters.ConfigResponse.UnknownTypes

Matrice di tipi non riconosciuti dal dispositivo che risponde.

Parameters.ConfigResponse.NumUnknownTypes

Numero di tipi non riconosciuti nel membro UnknownTypes .

Parameters.ConfigResponse.NewRequestParams

Struttura CHANNEL_CONFIG_PARAMETERS_ENHANCED che contiene le impostazioni dei parametri per la funzione di callback avanzata da inviare di nuovo dopo che la risposta è stata restituita dal dispositivo remoto.

Parameters.ConfigResponse.Response

Flag che indica lo stato della richiesta di configurazione. I valori di flag validi sono elencati nella tabella seguente:

Flag Descrizione
CONFIG_STATUS_SUCCESS La richiesta di configurazione ha avuto esito positivo.
CONFIG_STATUS_DISCONNECT La richiesta di configurazione non è riuscita perché la connessione L2CAP avanzata è stata disconnessa.
CONFIG_STATUS_INVALID_PARAMETER La richiesta di configurazione non è riuscita perché un parametro non valido è stato passato al driver del profilo.
CONFIG_STATUS_REJECT Il driver del profilo ha rifiutato la richiesta di configurazione.
CONFIG_STATUS_UNKNOWN_OPTION La richiesta di configurazione non è riuscita perché una delle opzioni di configurazione specificate non è stata riconosciuta dal driver del profilo.

Parameters.FreeExtraOptions

Struttura che contiene parametri per il valore di IndicationFreeExtraOptions INDICATION_CODE.

Parameters.FreeExtraOptions.NumExtraOptions

Numero di opzioni aggiuntive contenute nel membro ExtraOptions .

Parameters.FreeExtraOptions.ExtraOptions

Opzioni aggiuntive.

Parameters.Disconnect

Struttura che contiene i parametri per il valore di IndicationRemoteDisconnect INDICATION_CODE.

Parameters.Disconnect.Reason

Valore L2CAP_DISCONNECT_REASON che indica il motivo per cui la connessione L2CAP al dispositivo remoto è stata terminata.

Parameters.Disconnect.CloseNow

Valore booleano usato da un driver di profilo per notificare allo stack di driver Bluetooth di chiudere la connessione L2CAP. Impostare questo membro su TRUE per notificare allo stack di driver Bluetooth di chiudere la connessione. In caso contrario, impostarlo su FALSE per mantenere aperta la connessione.

Parameters.RecvPacket

Struttura che contiene i parametri per il valore di IndicationRecvPacket INDICATION_CODE.

Parameters.RecvPacket.PacketLength

Dimensione, in byte, del pacchetto inviato dalla funzione di callback sulla connessione L2CAP.

Parameters.RecvPacket.TotalQueueLength

Numero di pacchetti da elaborare sulla connessione L2CAP.

Parameters.Reserved

Membro riservato. Non usare.

Requisiti

Requisito Valore
Client minimo supportato Versioni:_Supported in Windows 8 e versioni successive di Windows
Intestazione bthddi.h (include Bthddi.h)