struktur SPB_CONNECTION_PARAMETERS (spbcx.h)

Artikel
08/07/2023

Struktur SPB_CONNECTION_PARAMETERS berisi parameter koneksi untuk perangkat target pada bus periferal sederhana.

Sintaks

typedef struct _SPB_CONNECTION_PARAMETERS {
  USHORT Size;
  PCWSTR ConnectionTag;
  PVOID  ConnectionParameters;
} SPB_CONNECTION_PARAMETERS, *PSPB_CONNECTION_PARAMETERS;

Anggota

Size

Ukuran, dalam byte, dari struktur ini. Metode SpbTargetGetConnectionParameters menggunakan nilai Ukuran untuk menentukan versi struktur mana yang sedang digunakan. Gunakan fungsi SPB_CONNECTION_PARAMETERS_INIT untuk menginisialisasi anggota ini. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

ConnectionTag

Penunjuk ke tag koneksi untuk target ini. Tag koneksi adalah string buram yang berisi ID koneksi yang mengidentifikasi koneksi perangkat target ke bus. Untuk informasi selengkapnya, lihat ID Koneksi untuk Perangkat Periferal SPB-Connected.

ConnectionParameters

Penunjuk ke parameter koneksi untuk target ini. Anggota ini menunjuk ke buffer memori yang berisi parameter khusus target yang perlu dikomunikasikan oleh driver pengontrol SPB dengan target. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Keterangan

Struktur ini berisi informasi tentang koneksi perangkat target ke bus. Ketika klien (driver periferal) membuka koneksi logis ke perangkat target, driver pengontrol SPB mengambil pengaturan koneksi untuk perangkat dan menyimpan pengaturan ini. Kemudian, sebagai respons terhadap permintaan I/O dari klien ke perangkat, driver pengontrol SPB menggunakan pengaturan koneksi untuk mengonfigurasi pengontrol untuk mengakses perangkat melalui bus.

Misalnya, pengaturan koneksi untuk perangkat pada bus I2C mencakup hal berikut:

Alamat relatif bus dari perangkat target.
Jumlah bit alamat yang digunakan untuk mengakses perangkat target.
Frekuensi jam bus yang digunakan untuk mengakses perangkat target.

Anggota ConnectionParameters dari struktur SPB_CONNECTION_PARAMETERS adalah penunjuk ke buffer yang berisi pengaturan koneksi untuk perangkat target di bus. Untuk contoh kode yang menggunakan anggota ConnectionParameters untuk mendapatkan parameter koneksi ini, lihat Cara Mendapatkan Pengaturan Koneksi untuk Perangkat.

Panggil metode SpbTargetGetConnectionParameters untuk mendapatkan parameter koneksi untuk handel SPBTARGET yang mewakili perangkat target. Metode ini menulis parameter koneksi ke struktur SPB_CONNECTION_PARAMETERS yang disediakan penelepon. Sebelum meneruskan struktur ini ke SpbTargetGetConnectionParameters, inisialisasi struktur dengan memanggil fungsi SPB_CONNECTION_PARAMETERS_INIT .

Untuk membuka koneksi atas nama klien (driver periferal), ekstensi kerangka kerja SPB (SpbCx) memanggil fungsi panggilan balik EvtSpbTargetConnect driver pengontrol SPB Anda. Untuk menutup koneksi, SpbCx memanggil fungsi panggilan balik EvtSpbTargetDisconnect driver pengontrol SPB. Driver pengontrol SPB biasanya memanggil SpbTargetGetConnectionParameters dari fungsi EvtSpbTargetConnect driver.