struktur INDICATION_PARAMETERS (bthddi.h)

Artikel
03/08/2023

Struktur INDICATION_PARAMETERS diteruskan sebagai parameter Parameter ke Fungsi Panggilan Balik L2CAP driver profil

Sintaks

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;

Anggota

ConnectionHandle

Handel koneksi L2CAP ke perangkat jarak jauh. Handel ini hanya berlaku untuk pemberitahuan yang tiba melalui koneksi L2CAP yang dibuat.

BtAddress

Alamat Bluetooth perangkat jarak jauh.

Parameters

Parameters.Connect

Struktur yang berisi parameter untuk fungsi panggilan balik IndicationRemoteConnect .

Parameters.Connect.Request

Struktur yang berisi parameter untuk permintaan koneksi.

Parameters.Connect.Request.PSM

Protocol/Service Multiplexer (PSM) yang diteruskan ke fungsi panggilan ketika nilai IndicationRemoteConnectINDICATION_CODE ditentukan dalam parameter Indikasi fungsi callback.

Parameters.ConfigRequest

Struktur yang berisi parameter untuk nilai IndicationRemoteConfigRequestINDICATION_CODE .

Parameters.ConfigRequest.CurrentParams

Struktur CHANNEL_CONFIG_PARAMETERS yang berisi parameter untuk saluran saat ini. Nilai ini hanya valid jika saluran sebelumnya terbuka dan sekarang sedang dalam proses dikonfigurasi. Anggota ini digunakan ketika fungsi panggilan balik menentukan nilai IndicationRemoteConfigRequestINDICATION_CODE .

Parameters.ConfigRequest.RequestedParams

Struktur CHANNEL_CONFIG_PARAMETERS yang berisi parameter yang diteruskan dari host jarak jauh untuk permintaan konfigurasi. Anggota ini digunakan ketika fungsi panggilan balik menentukan nilai IndicationRemoteConfigRequestINDICATION_CODE .

Parameters.ConfigRequest.ResponseParams

Struktur CHANNEL_CONFIG_PARAMETERS yang berisi parameter yang direspons driver profil terhadap permintaan konfigurasi.

Parameters.ConfigRequest.Response

Bendera yang menunjukkan status permintaan konfigurasi. Nilai bendera yang valid tercantum dalam tabel berikut ini.

Bendera	Deskripsi
CONFIG_STATUS_SUCCESS	Permintaan konfigurasi berhasil.
CONFIG_STATUS_DISCONNECT	Permintaan konfigurasi gagal karena koneksi L2CAP terputus.
CONFIG_STATUS_INVALID_PARAMETER	Permintaan konfigurasi gagal karena parameter yang tidak valid diteruskan ke driver profil.
CONFIG_STATUS_REJECT	Driver profil menolak permintaan konfigurasi.
CONFIG_STATUS_UNKNOWN_OPTION	Permintaan konfigurasi gagal karena salah satu opsi konfigurasi yang ditentukan tidak dikenali oleh driver profil.

Parameters.ConfigResponse

Struktur yang berisi parameter untuk nilai IndicationRemoteConfigResponseINDICATION_CODE .

Parameters.ConfigResponse.CurrentParams

Parameters.ConfigResponse.RequestedParams

Parameters.ConfigResponse.RejectedParams

Struktur *CHANNEL_CONFIG_PARAMETERS yang berisi pengaturan parameter konfigurasi yang ditolak oleh perangkat jarak jauh.

Parameters.ConfigResponse.UnknownTypes

Array jenis yang tidak dikenali oleh perangkat yang merespons.

Parameters.ConfigResponse.NumUnknownTypes

Jumlah jenis yang tidak dikenali di anggota UnknownTypes .

Parameters.ConfigResponse.NewRequestParams

Struktur *CHANNEL_CONFIG_PARAMETERS yang berisi pengaturan parameter untuk fungsi panggilan balik untuk mengirim ulang setelah respons dikembalikan dari perangkat jarak jauh.

Parameters.ConfigResponse.Response

Bendera yang menunjukkan status permintaan konfigurasi. Nilai bendera yang valid tercantum dalam tabel berikut ini.

Bendera	Deskripsi
CONFIG_STATUS_SUCCESS	Permintaan konfigurasi berhasil.
CONFIG_STATUS_DISCONNECT	Permintaan konfigurasi gagal karena koneksi L2CAP terputus.
CONFIG_STATUS_INVALID_PARAMETER	Permintaan konfigurasi gagal karena parameter yang tidak valid diteruskan ke driver profil.
CONFIG_STATUS_REJECT	Driver profil menolak permintaan konfigurasi.
CONFIG_STATUS_UNKNOWN_OPTION	Permintaan konfigurasi gagal karena salah satu opsi konfigurasi yang ditentukan tidak dikenali oleh driver profil.

Parameters.FreeExtraOptions

Struktur yang berisi parameter untuk nilai IndicationFreeExtraOptionsINDICATION_CODE .

Parameters.FreeExtraOptions.NumExtraOptions

Jumlah opsi tambahan yang terkandung dalam anggota ExtraOptions .

Parameters.FreeExtraOptions.ExtraOptions

Jumlah opsi tambahan yang terkandung dalam anggota ExtraOptions .

Parameters.Disconnect

Struktur yang berisi parameter untuk nilai IndicationRemoteDisconnectINDICATION_CODE .

Parameters.Disconnect.Reason

Nilai L2CAP_DISCONNECT_REASON yang menunjukkan mengapa koneksi L2CAP ke perangkat jarak jauh dihentikan.

Parameters.Disconnect.CloseNow

Nilai Boolean yang digunakan driver profil untuk memberi tahu tumpukan driver Bluetooth untuk menutup koneksi L2CAP. Atur anggota ini ke TRUE untuk memberi tahu tumpukan driver Bluetooth untuk menutup koneksi. Jika tidak, atur ke FALSE untuk menjaga koneksi tetap terbuka.

Parameters.RecvPacket

Struktur yang berisi parameter untuk nilai IndicationRecvPacketINDICATION_CODE .

Parameters.RecvPacket.PacketLength

Ukuran, dalam byte, dari paket yang dikirim fungsi panggilan balik melalui koneksi L2CAP.

Parameters.RecvPacket.TotalQueueLength

Jumlah paket yang akan diproses melalui koneksi L2CAP.

Keterangan

Fungsi Panggilan Balik L2CAP driver profil harus memproses struktur ini secara berbeda tergantung pada nilai yang diteruskan tumpukan driver Bluetooth dalam parameter Indikasi fungsi panggilan balik.

Ketika tumpukan driver Bluetooth melewati IndicationRemoteConnect, fungsi panggilan balik harus menggunakan anggota Sambungkan dari union Parameter .
Ketika tumpukan driver Bluetooth melewati IndicationRemoteDisconnect, fungsi panggilan balik harus menggunakan anggota Putuskan sambungan dari union Parameter .
Ketika tumpukan driver Bluetooth melewati IndicationRemoteConfigRequest, fungsi panggilan balik harus menggunakan anggota ConfigRequest dari union Parameter .
Ketika tumpukan driver Bluetooth melewati IndicationRemoteConfigResponse, fungsi panggilan balik harus menggunakan anggota ConfigResponse dari union Parameter .
Ketika tumpukan driver Bluetooth melewati IndicationRemoteFreeExtraOptions, fungsi panggilan balik harus menggunakan anggota FreeExtraOptions dari serikat Parameter .
Ketika tumpukan driver Bluetooth melewati IndicationRemoteRecvPacket, fungsi panggilan balik harus menggunakan anggota RecvPacket dari union Parameter .