struttura RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER (reshub.h)
La struttura RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER contiene le proprietà di connessione per un dispositivo di destinazione connesso a un bus seriale (I2C, SPI o UART).
Sintassi
typedef struct _RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER {
ULONG Version;
ULONG PropertiesLength;
UCHAR ConnectionProperties[ANYSIZE_ARRAY];
} RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER, *PRH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER;
Members
Version
Numero di versione di questa struttura. Questo membro è impostato sulla costante RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_VERSION, definita nel file di intestazione Reshub.h.
PropertiesLength
Dimensione, in byte, del descrittore di connessione del bus seriale che inizia con l'elemento 0 della matrice ConnectionProperties .
ConnectionProperties[ANYSIZE_ARRAY]
Primo byte del descrittore di connessione del bus seriale. Questo byte viene immediatamente seguito dai byte rimanenti del descrittore. Il membro PropertiesLength specifica il numero totale di byte occupati dal descrittore. La definizione del membro ConnectionProperties utilizza la costante ANYSIZE_ARRAY, che il file di intestazione Ntdef.h definisce come 1. Per altre informazioni, vedere la sezione Osservazioni.
Commenti
Il membro ConnectionProperties della struttura RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER contiene il primo byte del descrittore di connessione del bus seriale per il dispositivo di destinazione. I byte rimanenti nel descrittore seguono immediatamente questo membro in memoria. Il buffer allocato per la struttura RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER è sufficientemente grande da contenere questa struttura e i byte rimanenti del descrittore di connessione del bus seriale che si estendono oltre la fine della struttura.
Il formato per il descrittore di connessione del bus seriale è descritto nella specifica ACPI 5.0. Per praticità, il file di intestazione Reshub.h definisce la struttura PNP_SERIAL_BUS_DESCRIPTOR per consentire ai driver di accedere ai valori in questo descrittore.
Un driver del controller SPB chiama il metodo SpbTargetGetConnectionParameters per ottenere i parametri di connessione per un dispositivo di destinazione in un bus periferico semplice (in genere, I²C o SPI). Questo metodo scrive i parametri di connessione in una struttura SPB_CONNECTION_PARAMETERS e il membro ConnectionParameters di questa struttura è un puntatore a una struttura RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER .
Per un esempio di codice che usa la struttura RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER , vedere Come ottenere le impostazioni di connessione per un dispositivo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato a partire da Windows 8. |
| Intestazione | reshub.h |