SPB_CONNECTION_PARAMETERS-Struktur (spbcx.h)

Artikel
08/07/2023

Die SPB_CONNECTION_PARAMETERS-Struktur enthält die Verbindungsparameter für ein Zielgerät auf einem einfachen Peripheriebus.

Syntax

typedef struct _SPB_CONNECTION_PARAMETERS {
  USHORT Size;
  PCWSTR ConnectionTag;
  PVOID  ConnectionParameters;
} SPB_CONNECTION_PARAMETERS, *PSPB_CONNECTION_PARAMETERS;

Member

Size

Die Größe (in Bytes) dieser Struktur. Die SpbTargetGetConnectionParameters-Methode verwendet den Size-Wert , um zu bestimmen, welche Version dieser Struktur verwendet wird. Verwenden Sie die funktion SPB_CONNECTION_PARAMETERS_INIT , um diesen Member zu initialisieren. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

ConnectionTag

Ein Zeiger auf das Verbindungstag für dieses Ziel. Das Verbindungstag ist eine undurchsichtige Zeichenfolge, die eine Verbindungs-ID enthält, die die Verbindung des Zielgeräts mit dem Bus identifiziert. Weitere Informationen finden Sie unter Verbindungs-IDs für SPB-Connected Peripheriegeräte.

ConnectionParameters

Ein Zeiger auf die Verbindungsparameter für dieses Ziel. Dieser Member verweist auf einen Speicherpuffer, der die zielspezifischen Parameter enthält, die der SPB-Controllertreiber für die Kommunikation mit dem Ziel benötigt. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Hinweise

Diese Struktur enthält Informationen über die Verbindung eines Zielgeräts mit dem Bus. Wenn ein Client (Peripherietreiber) eine logische Verbindung mit dem Zielgerät öffnet, ruft der SPB-Controllertreiber die Verbindungseinstellungen für das Gerät ab und speichert diese Einstellungen. Später verwendet der SPB-Controllertreiber als Reaktion auf eine E/A-Anforderung vom Client an das Gerät die Verbindungseinstellungen, um den Controller für den Zugriff auf das Gerät über den Bus zu konfigurieren.

Die Verbindungseinstellungen für ein Gerät in einem I2C-Bus umfassen beispielsweise Folgendes:

Die busrelative Adresse des Zielgeräts.
Die Anzahl der Adressbits, die für den Zugriff auf das Zielgerät verwendet werden sollen.
Die Bustaktfrequenz, die für den Zugriff auf das Zielgerät verwendet werden soll.

Das ConnectionParameters-Element der SPB_CONNECTION_PARAMETERS-Struktur ist ein Zeiger auf einen Puffer, der die Verbindungseinstellungen für ein Zielgerät im Bus enthält. Ein Codebeispiel, das den ConnectionParameters-Member zum Abrufen dieser Verbindungsparameter verwendet, finden Sie unter Abrufen der Verbindungseinstellungen für ein Gerät.

Rufen Sie die SpbTargetGetConnectionParameters-Methode auf, um die Verbindungsparameter für ein SPBTARGET-Handle abzurufen, das das Zielgerät darstellt. Diese Methode schreibt die Verbindungsparameter in eine vom Aufrufer bereitgestellte SPB_CONNECTION_PARAMETERS-Struktur . Bevor Sie diese Struktur an SpbTargetGetConnectionParameters übergeben, initialisieren Sie die -Struktur, indem Sie die SPB_CONNECTION_PARAMETERS_INIT-Funktion aufrufen.

Um eine Verbindung im Namen eines Clients (Peripherietreiber) zu öffnen, ruft die SPB-Frameworkerweiterung (SpbCx) die Rückruffunktion EvtSpbTargetConnect des SPB-Controllertreibers auf. Um die Verbindung zu schließen, ruft SpbCx die Rückruffunktion EvtSpbTargetDisconnect des SPB-Controllertreibers auf. Ein SPB-Controllertreiber ruft in der Regel SpbTargetGetConnectionParameters über die EvtSpbTargetConnect-Funktion des Treibers auf.