RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER-Struktur (reshub.h)
Die RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER-Struktur enthält die Verbindungseigenschaften für ein Zielgerät, das mit einem seriellen Bus (I2C, SPI oder UART) verbunden ist.
Syntax
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;
Member
Version
Die Versionsnummer dieser Struktur. Dieser Member ist auf die RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_VERSION-Konstante festgelegt, die in der Headerdatei Reshub.h definiert ist.
PropertiesLength
Die Größe des seriellen Busverbindungsdeskriptors in Bytes, der mit Element 0 des ConnectionProperties-Arrays beginnt.
ConnectionProperties[ANYSIZE_ARRAY]
Das erste Byte des Seriellen Busverbindungsdeskriptors. Diesem Byte folgen unmittelbar die verbleibenden Bytes des Deskriptors. Das PropertiesLength-Element gibt die Gesamtanzahl der Bytes an, die vom Deskriptor belegt werden. Die Definition des ConnectionProperties-Members verwendet die ANYSIZE_ARRAY Konstante, die von der Ntdef.h-Headerdatei als 1 definiert wird. Weitere Informationen finden Sie in den Hinweisen.
Hinweise
Das ConnectionProperties-Element der RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER-Struktur enthält das erste Byte des Seriellen Busverbindungsdeskriptors für das Zielgerät. Die restlichen Bytes im Deskriptor folgen diesem Element sofort im Arbeitsspeicher. Der für die RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER-Struktur zugewiesene Puffer ist groß genug, um diese Struktur plus die verbleibenden Bytes des Deskriptors für die serielle Busverbindung zu enthalten, die über das Ende der Struktur hinaus reichen.
Das Format für den Seriellen Busverbindungsdeskriptor wird in der ACPI 5.0-Spezifikation beschrieben. Der Einfachheit halber definiert die Reshub.h-Headerdatei die PNP_SERIAL_BUS_DESCRIPTOR-Struktur , damit Treiber auf die Werte in diesem Deskriptor zugreifen können.
Ein SPB-Controllertreiber ruft die SpbTargetGetConnectionParameters-Methode auf, um die Verbindungsparameter für ein Zielgerät auf einem einfachen Peripheriebus (in der Regel I²C oder SPI) abzurufen. Diese Methode schreibt die Verbindungsparameter in eine SPB_CONNECTION_PARAMETERS-Struktur , und das ConnectionParameters-Element dieser Struktur ist ein Zeiger auf eine RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER Struktur.
Ein Codebeispiel, das die RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER-Struktur verwendet, finden Sie unter Abrufen der Verbindungseinstellungen für ein Gerät.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Wird ab Windows 8 unterstützt. |
| Kopfzeile | reshub.h |