fungsi GPIO_CLX_RegisterClient (gpioclx.h)

Artikel
02/26/2024

Metode GPIO_CLX_RegisterClient mendaftarkan driver pengontrol I/O (GPIO) tujuan umum sebagai klien ekstensi kerangka kerja GPIO (GpioClx).

Sintaks

NTSTATUS GPIO_CLX_RegisterClient(
  [in]      WDFDRIVER                        Driver,
  [in, out] PGPIO_CLIENT_REGISTRATION_PACKET RegistrationPacket,
  [in]      PUNICODE_STRING                  RegistryPath
);

Parameter

[in] Driver

Handel WDFDRIVER ke objek driver kerangka kerja untuk driver pengontrol GPIO.

[in, out] RegistrationPacket

Penunjuk ke struktur GPIO_CLIENT_REGISTRATION_PACKET yang dialokasikan pemanggil yang berisi informasi pendaftaran pemanggil. Struktur ini berisi pointer ke fungsi panggilan balik peristiwa yang diterapkan driver pengontrol GPIO. Selain itu, struktur ini menentukan ukuran konteks perangkat yang diperlukan driver pengontrol GPIO untuk data konfigurasi internal dan informasi statusnya.

[in] RegistryPath

Penunjuk ke struktur UNICODE_STRING yang berisi nama jalur kunci registri untuk driver pengontrol GPIO. Parameter ini harus menjadi nama jalur registri yang diteruskan ke rutinitas DriverEntry driver. Untuk informasi selengkapnya tentang kunci registri driver, lihat Pohon Registri untuk Perangkat dan Driver.

Nilai kembali

GPIO_CLX_RegisterClient mengembalikan STATUS_SUCCESS jika panggilan berhasil. Nilai yang mungkin dikembalikan termasuk kode kesalahan berikut.

Menampilkan kode	Deskripsi
STATUS_INVALID_PARAMETER	Parameter Driver, RegistrationPacket, atau RegistryPath adalah NULL.
STATUS_GPIO_INVALID_REGISTRATION_PACKET	Paket pendaftaran yang ditentukan tidak valid.
STATUS_INSUFFICIENT_RESOURCES	Kehabisan memori.

Keterangan

Driver pengontrol GPIO memanggil metode ini untuk mendaftarkan fungsi panggilan balik peristiwanya dengan GpioClx. Biasanya, driver memanggil metode ini dari rutinitas DriverEntry-nya , yang berjalan tak lama setelah driver dimuat ke dalam memori.

Kemudian, tepat sebelum driver pengontrol GPIO membongkar, driver memanggil metode GPIO_CLX_UnregisterClient untuk membatalkan pendaftarannya dengan GpioClx.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 8.
Target Platform	Universal
Header	gpioclx.h
Pustaka	Msgpioclxstub.lib
IRQL	PASSIVE_LEVEL

Lihat juga

DriverEntry

GPIO_CLIENT_REGISTRATION_PACKET

GPIO_CLX_UnregisterClient

UNICODE_STRING

Bagikan melalui