funzione GPIO_CLX_RegisterClient (gpioclx.h)

  • Articolo

Il metodo GPIO_CLX_RegisterClient registra un driver controller di I/O per utilizzo generico (GPIO) come client dell'estensione del framework GPIO (GpioClx).

Sintassi

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

Parametri

[in] Driver

Handle WDFDRIVER per l'oggetto driver del framework per il driver del controller GPIO.

[in, out] RegistrationPacket

Puntatore a una struttura di GPIO_CLIENT_REGISTRATION_PACKET allocata dal chiamante che contiene le informazioni di registrazione del chiamante. Questa struttura contiene puntatori alle funzioni di callback degli eventi implementate dal driver del controller GPIO. Inoltre, questa struttura specifica le dimensioni del contesto di dispositivo richieste dal driver del controller GPIO per i dati di configurazione interni e le informazioni sullo stato.

[in] RegistryPath

Puntatore a una struttura UNICODE_STRING che contiene il nome del percorso della chiave del Registro di sistema per il driver del controller GPIO. Questo parametro deve essere il nome del percorso del Registro di sistema passato alla routine DriverEntry del driver. Per altre informazioni sulle chiavi del Registro di sistema dei driver, vedere Alberi del Registro di sistema per dispositivi e driver.

Valore restituito

GPIO_CLX_RegisterClient restituisce STATUS_SUCCESS se la chiamata ha esito positivo. I valori restituiti possibili includono i codici di errore seguenti.

Codice restituito Descrizione
STATUS_INVALID_PARAMETER
 Il parametro Driver, RegistrationPacket o RegistryPath è NULL.
STATUS_GPIO_INVALID_REGISTRATION_PACKET
 Il pacchetto di registrazione specificato non è valido.
STATUS_INSUFFICIENT_RESOURCES
 Memoria insufficiente.

Commenti

Il driver del controller GPIO chiama questo metodo per registrare le funzioni di callback degli eventi con GpioClx. In genere, il driver chiama questo metodo dalla routine DriverEntry , che viene eseguito poco dopo il caricamento del driver in memoria.

Successivamente, poco prima che il driver del controller GPIO scarica, il driver chiama il metodo GPIO_CLX_UnregisterClient per annullare la registrazione con GpioClx.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 8.
Piattaforma di destinazione Universale
Intestazione gpioclx.h
Libreria Msgpioclxstub.lib
IRQL PASSIVE_LEVEL

Vedi anche

DriverEntry

GPIO_CLIENT_REGISTRATION_PACKET

GPIO_CLX_UnregisterClient

UNICODE_STRING