struktur INDICATION_PARAMETERS_ENHANCED (bthddi.h)

  • Artikel

Struktur INDICATION_PARAMETERS_ENHANCED diteruskan sebagai parameter Parameter ke Fungsi Panggilan Balik L2CAP driver profil yang ditingkatkan

Sintaks

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;

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 pemanggilan ketika nilai indikasiRemoteConnect INDICATION_CODE ditentukan dalam parameter Indikasi fungsi panggilan balik yang disempurnakan.

Parameters.ConfigRequest

Struktur yang berisi parameter untuk nilai indicationRemoteConfigRequest INDICATION_CODE.

Parameters.ConfigRequest.CurrentParams

Struktur CHANNEL_CONFIG_PARAMETERS_ENHANCED 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 indikasiRemoteConfigRequest INDICATION_CODE.

Parameters.ConfigRequest.RequestedParams

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

Parameters.ConfigRequest.ResponseParams

Struktur CHANNEL_CONFIG_PARAMETERS_ENHANCED 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 yang ditingkatkan 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 indicationRemoteConfigResponse INDICATION_CODE.

Parameters.ConfigResponse.CurrentParams

Struktur CHANNEL_CONFIG_PARAMETERS_ENHANCED 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 indikasiRemoteConfigRequest INDICATION_CODE.

Parameters.ConfigResponse.RequestedParams

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

Parameters.ConfigResponse.RejectedParams

Struktur CHANNEL_CONFIG_PARAMETERS_ENHANCED 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_ENHANCED yang berisi pengaturan parameter untuk fungsi panggilan balik yang ditingkatkan 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:

Bendera Deskripsi
CONFIG_STATUS_SUCCESS Permintaan konfigurasi berhasil.
CONFIG_STATUS_DISCONNECT Permintaan konfigurasi gagal karena koneksi L2CAP yang ditingkatkan 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 INDICATION_CODE IndicationFreeExtraOptions .

Parameters.FreeExtraOptions.NumExtraOptions

Jumlah opsi tambahan yang terkandung dalam anggota ExtraOptions .

Parameters.FreeExtraOptions.ExtraOptions

Opsi tambahan.

Parameters.Disconnect

Struktur yang berisi parameter untuk nilai INDICATION_CODE IndicationRemoteDisconnect .

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 indikasiRecvPacket INDICATION_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.

Parameters.Reserved

Anggota yang dipesan. Jangan gunakan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Versi:_Supported di windows versi Windows 8 dan yang lebih baru
Header bthddi.h (termasuk Bthddi.h)