structure RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER (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 Remarques.
Remarques
Le ConnectionProperties membre 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, ainsi que 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 plus de commodité, 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 la ConnectionParameters membre 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge à partir de Windows 8. |
| d’en-tête | reshub.h |