struktur CLIENT_CONTROLLER_BASIC_INFORMATION (gpioclx.h)

Artikel
02/29/2024

Struktur CLIENT_CONTROLLER_BASIC_INFORMATION berisi atribut perangkat keras dan informasi konfigurasi pengontrol I/O (GPIO) tujuan umum.

Sintaks

typedef struct _CLIENT_CONTROLLER_BASIC_INFORMATION {
  USHORT                     Version;
  USHORT                     Size;
  USHORT                     TotalPins;
  UCHAR                      NumberOfPinsPerBank;
  ULONG                      DeviceIdleTimeout;
  CONTROLLER_ATTRIBUTE_FLAGS Flags;
} CLIENT_CONTROLLER_BASIC_INFORMATION, *PCLIENT_CONTROLLER_BASIC_INFORMATION;

Anggota

Version

Nomor versi struktur ini. Atur anggota ini ke GPIO_CONTROLLER_BASIC_INFORMATION_VERSION, yang didefinisikan dalam file header Gpioclx.h.

Size

Ukuran, dalam byte, dari struktur ini. Atur anggota ini ke sizeof(CLIENT_CONTROLLER_BASIC_INFORMATION).

TotalPins

Jumlah pin pada pengontrol GPIO. Jika pin dipartisi ke dalam beberapa bank, anggota ini menentukan jumlah total pin di semua bank di pengontrol GPIO.

NumberOfPinsPerBank

Jumlah pin GPIO untuk setiap bank. Jumlah maksimum pin untuk setiap bank adalah 64. Pin pada pengontrol GPIO dipartisi ke dalam satu atau beberapa bank. Setiap bank berisi jumlah pin yang ditentukan oleh parameter ini, dengan kemungkinan pengecualian bank terakhir. Untuk informasi selengkapnya, lihat Keterangan.

DeviceIdleTimeout

Interval batas waktu diam, dalam milidetik, jika pengontrol GPIO mendukung status daya D3. Interval waktu habis adalah jumlah waktu minimum pengontrol GPIO tetap dalam status D0 setelah pengontrol diam. Setelah interval waktu habis berakhir, manajer daya mungkin meminta agar pengontrol beralih ke status D3.

Flags

Sekumpulan bendera yang menentukan atribut perangkat keras pengontrol GPIO. Anggota ini dapat diatur ke semua nol atau ke kombinasi bitwise-OR dari bit bendera berikut:

MemoryMappedController
ActiveInterruptsAutoClearOnRead
FormatIoRequestsAsMasks
DeviceIdlePowerMgmtSupported
BankIdlePowerMgmtSupported
EmulasiDebouncing
EmulateActiveBoth

Untuk informasi selengkapnya, lihat CONTROLLER_ATTRIBUTE_FLAGS.

Keterangan

Fungsi panggilan balik peristiwa CLIENT_QueryControllerBasicInformation menggunakan struktur CLIENT_CONTROLLER_BASIC_INFORMATION untuk meneruskan informasi khusus perangkat tentang pengontrol GPIO ke ekstensi kerangka kerja GPIO (GpioClx).

Driver pengontrol GPIO dapat mempartisi pin di perangkat pengontrol GPIO ke dalam beberapa bank. Jika N adalah jumlah bank di pengontrol, bank bernomor 0 hingga N–1. Semua kecuali bank terakhir (yaitu, nomor bank N–1) harus berisi jumlah pin yang ditentukan dalam anggota NumberOfPinsPerBank . Bank terakhir dapat memiliki sejumlah pin dari satu ke NumberOfPinsPerBank.

GpioClx menentukan jumlah total bank dalam pengontrol GPIO dari nilai anggota TotalPins dan NumberOfPinsPerBank . GpioClx menggunakan rumus bilangan bulat berikut untuk menghitung jumlah total bank:

TotalPinsNumberOfPinsPerBank NumberOfPinsPerBank Biasanya, bank dalam perangkat pengontrol GPIO dapat diaktifkan dan dinonaktifkan secara independen dari bank lain di perangkat yang sama. Dengan demikian, daya dapat dihemat dengan mematikan bank yang tidak aktif.

Persyaratan

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

Lihat juga

CLIENT_QueryControllerBasicInformation

CONTROLLER_ATTRIBUTE_FLAGS

Bagikan melalui