Freigeben über


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;

Angehörige

Version

Die Versionsnummer dieser Struktur. Dieses Element wird auf die RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_VERSION Konstante festgelegt, die in der Reshub.h-Headerdatei definiert ist.

PropertiesLength

Die Größe des seriellen Busverbindungsdeskriptors in Bytes, der mit Element 0 des ConnectionProperties Array beginnt.

ConnectionProperties[ANYSIZE_ARRAY]

Das erste Byte des seriellen Busverbindungsdeskriptors. Auf dieses Byte folgt unmittelbar die verbleibenden Bytes des Deskriptors. Das PropertiesLength Member gibt die Gesamtanzahl der Bytes an, die vom Deskriptor belegt wurden. Die Definition der ConnectionProperties Member verwendet die ANYSIZE_ARRAY Konstante, die die Ntdef.h-Headerdatei als 1 definiert. Weitere Informationen finden Sie in den Hinweisen.

Bemerkungen

Das ConnectionProperties Member 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 sofort diesem Element im Arbeitsspeicher. Der für die RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER Struktur zugewiesene Puffer ist groß genug, um diese Struktur sowie die verbleibenden Bytes des seriellen Busverbindungsdeskriptors zu enthalten, die über das Ende der Struktur hinaus reichen.

Das Format für den seriellen Busverbindungsdeskriptor wird in der ACPI 5.0-Spezifikationbeschrieben. Aus Gründen der Einfachheit definiert die Reshub.h-Headerdatei die PNP_SERIAL_BUS_DESCRIPTOR Struktur, um Treibern den Zugriff auf die Werte in diesem Deskriptor zu ermöglichen.

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 How to Get the Connection Settings for a Device.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Wird ab Windows 8 unterstützt.
Header- reshub.h

Siehe auch

SPB_CONNECTION_PARAMETERS

SpbTargetGetConnectionParameters

PNP_SERIAL_BUS_DESCRIPTOR