struktur RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER (reshub.h)

Artikel
02/29/2024

Struktur RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER berisi properti koneksi untuk perangkat target yang tersambung ke bus serial (I2C, SPI, atau UART).

Sintaks

typedef struct _RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER {
  ULONG Version;
  ULONG PropertiesLength;
  UCHAR ConnectionProperties[ANYSIZE_ARRAY];
} RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER, *PRH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER;

Anggota

Version

Nomor versi struktur ini. Anggota ini diatur ke konstanta RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_VERSION, yang didefinisikan dalam file header Reshub.h.

PropertiesLength

Ukuran, dalam byte, dari deskriptor koneksi bus serial yang dimulai dengan elemen 0 dari array ConnectionProperties .

ConnectionProperties[ANYSIZE_ARRAY]

Byte pertama dari pendeskripsi koneksi bus serial. Byte ini segera diikuti oleh byte deskriptor yang tersisa. Anggota PropertiesLength menentukan jumlah total byte yang ditempati oleh deskriptor. Definisi anggota ConnectionProperties menggunakan konstanta ANYSIZE_ARRAY, yang didefinisikan file header Ntdef.h menjadi 1. Untuk informasi selengkapnya, lihat Keterangan.

Keterangan

Anggota ConnectionProperties dari struktur RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER berisi byte pertama dari deskriptor koneksi bus serial untuk perangkat target. Byte yang tersisa dalam deskriptor segera mengikuti anggota ini dalam memori. Buffer yang dialokasikan untuk struktur RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER cukup besar untuk berisi struktur ini ditambah byte yang tersisa dari deskriptor koneksi bus serial yang meluas melewati akhir struktur.

Format untuk deskriptor koneksi bus serial dijelaskan dalam spesifikasi ACPI 5.0. Untuk kenyamanan, file header Reshub.h menentukan struktur PNP_SERIAL_BUS_DESCRIPTOR untuk memungkinkan driver mengakses nilai dalam deskriptor ini.

Driver pengontrol SPB memanggil metode SpbTargetGetConnectionParameters untuk mendapatkan parameter koneksi untuk perangkat target pada bus periferal sederhana (biasanya, I²C atau SPI). Metode ini menulis parameter koneksi ke struktur SPB_CONNECTION_PARAMETERS , dan anggota ConnectionParameters dari struktur ini adalah penunjuk ke struktur RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER .

Untuk contoh kode yang menggunakan struktur RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER , lihat Cara Mendapatkan Pengaturan Koneksi untuk Perangkat.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung dimulai dengan Windows 8.
Header	reshub.h

Lihat juga

SPB_CONNECTION_PARAMETERS

SpbTargetGetConnectionParameters

PNP_SERIAL_BUS_DESCRIPTOR

Share via