SPB_CONNECTION_PARAMETERS struttura (spbcx.h)

Articolo
08/07/2023

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

Sintassi

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

Members

Size

Dimensione, in byte, della 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 ulteriori informazioni, vedere la sezione Osservazioni successiva.

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 contenente i parametri specifici della destinazione che il driver del controller SPB deve comunicare con la destinazione. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Commenti

Questa struttura contiene informazioni sulla connessione di un dispositivo di destinazione al bus. Quando un client (driver periferico) 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. In seguito, 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 sul 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 membro ConnectionParameters della struttura SPB_CONNECTION_PARAMETERS è un puntatore a un buffer che contiene 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 un dispositivo.

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 del framework SPB (SpbCx) chiama la funzione di callback del driver del controller SPB EvtSpbTargetConnect . Per chiudere la connessione, SpbCx chiama la funzione di callback del driver del controller SPB EvtSpbTargetDisconnect . Un driver controller SPB chiama in genere SpbTargetGetConnectionParameters dalla funzione EvtSpbTargetConnect del driver.