RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER structure (reshub.h)
La structure RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER contient les propriétés de connexion d’un appareil cible connecté à un bus série (I2C, SPI ou UART).
Syntaxe
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;
Membres
Version
Numéro de version de cette structure. Ce membre est défini sur la constante RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_VERSION, qui est définie dans le fichier d’en-tête Reshub.h.
PropertiesLength
Taille, en octets, du descripteur de connexion de bus série qui commence par l’élément 0 du tableau ConnectionProperties .
ConnectionProperties[ANYSIZE_ARRAY]
Premier octet du descripteur de connexion de bus série. Cet octet est immédiatement suivi des octets restants du descripteur. Le membre PropertiesLength spécifie le nombre total d’octets occupés par le descripteur. La définition du membre ConnectionProperties utilise la constante ANYSIZE_ARRAY, que le fichier d’en-tête Ntdef.h définit comme étant 1. Pour plus d'informations, consultez la section Notes.
Remarques
Le membre ConnectionProperties de la structure RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER contient le premier octet du descripteur de connexion de bus série pour l’appareil cible. Les octets restants dans le descripteur suivent immédiatement ce membre en mémoire. La mémoire tampon allouée pour la structure RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER est suffisamment grande pour contenir cette structure, plus les octets restants du descripteur de connexion de bus série qui s’étendent au-delà de la fin de la structure.
Le format du descripteur de connexion de bus série est décrit dans la spécification ACPI 5.0. Pour des raisons pratiques, le fichier d’en-tête Reshub.h définit la structure PNP_SERIAL_BUS_DESCRIPTOR pour permettre aux pilotes d’accéder aux valeurs de ce descripteur.
Un pilote de contrôleur SPB appelle la méthode SpbTargetGetConnectionParameters pour obtenir les paramètres de connexion d’un appareil cible sur un bus périphérique simple (généralement, I²C ou SPI). Cette méthode écrit les paramètres de connexion dans une structure SPB_CONNECTION_PARAMETERS , et le membre ConnectionParameters de cette structure est un pointeur vers une structure RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER .
Pour obtenir un exemple de code qui utilise la structure RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER , consultez Comment obtenir les paramètres de connexion d’un appareil.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge à partir de Windows 8. |
| En-tête | reshub.h |