struttura SPB_CONNECTION_PARAMETERS (spbcx.h)

Articolo
02/07/2025

La struttura SPB_CONNECTION_PARAMETERS contiene i parametri di connessione per un dispositivo di destinazione in un bus periferico semplice.

Sintassi

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

Membri

Size

Dimensione, in byte, di questa struttura. Il metodo SpbTargetGetConnectionParameters usa il valore Size per determinare quale versione di questa struttura viene usata. Usare la funzione SPB_CONNECTION_PARAMETERS_INIT per inizializzare questo membro. Per altre informazioni, vedere la sezione Osservazioni seguente.

ConnectionTag

Puntatore al tag di connessione per questa destinazione. Il tag di connessione è una stringa opaca che contiene un ID connessione che identifica la connessione del dispositivo di destinazione al bus. Per altre informazioni, vedere ID connessione per dispositivi periferici SPB-Connected.

ConnectionParameters

Puntatore ai parametri di connessione per questa destinazione. Questo membro punta a un buffer di memoria che contiene i parametri specifici della destinazione che il driver del controller SPB deve comunicare con la destinazione. Per altre informazioni, vedere la sezione Osservazioni seguente.

Osservazioni

Questa struttura contiene informazioni sulla connessione di un dispositivo di destinazione al bus. Quando un client (driver di periferica) apre una connessione logica al dispositivo di destinazione, il driver del controller SPB recupera le impostazioni di connessione per il dispositivo e archivia queste impostazioni. Successivamente, in risposta a una richiesta di I/O dal client al dispositivo, il driver del controller SPB usa le impostazioni di connessione per configurare il controller per accedere al dispositivo tramite il bus.

Ad esempio, le impostazioni di connessione per un dispositivo in un bus I2C includono quanto segue:

Indirizzo relativo al bus del dispositivo di destinazione.
Numero di bit di indirizzo da usare per accedere al dispositivo di destinazione.
Frequenza dell'orologio del bus da usare per accedere al dispositivo di destinazione.

Il ConnectionParameters membro della struttura SPB_CONNECTION_PARAMETERS è un puntatore a un buffer contenente le impostazioni di connessione per un dispositivo di destinazione nel bus. Per un esempio di codice che usa il membro connectionParameters per ottenere questi parametri di connessione, vedere Come ottenere le impostazioni di connessione per undispositivo.

Chiamare il metodo spbTargetGetConnectionParameters per ottenere i parametri di connessione per un handle SPBTARGET che rappresenta il dispositivo di destinazione. Questo metodo scrive i parametri di connessione in una struttura di SPB_CONNECTION_PARAMETERS fornita dal chiamante. Prima di passare questa struttura a SpbTargetGetConnectionParameters, inizializzare la struttura chiamando la funzione SPB_CONNECTION_PARAMETERS_INIT.

Per aprire una connessione per conto di un client (driver periferico), l'estensione spb framework (SpbCx) chiama il driver del controller SPB EvtSpbTargetConnect funzione di callback. Per chiudere la connessione, SpbCx chiama il driver del controller SPB EvtSpbTargetDisconnect funzione di callback. Un driver del controller SPB chiama in genere spbTargetGetConnectionParameters dalla funzione EvtSpbTargetConnect del driver.