Freigeben über

SPB_CONNECTION_PARAMETERS Struktur (spbcx.h)

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;

Angehörige

Size

Die Größe dieser Struktur in Byte. Die SpbTargetGetConnectionParameters--Methode verwendet den wert Size, um zu bestimmen, welche Version dieser Struktur verwendet wird. Verwenden Sie die SPB_CONNECTION_PARAMETERS_INIT-Funktion, um dieses Element 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. Dieses Element verweist auf einen Speicherpuffer, der die zielspezifischen Parameter enthält, die der SPB-Controllertreiber mit dem Ziel kommunizieren muss. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Bemerkungen

Diese Struktur enthält Informationen zur 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 auf 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 Für den Zugriff auf das Zielgerät zu verwendende Busuhrhäufigkeit.
Die ConnectionParameters Member 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 das ConnectionParameters Member verwendet, um diese Verbindungsparameter abzurufen, finden Sie unter How to Get the Connection Settings for a Device.

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 durch Aufrufen der SPB_CONNECTION_PARAMETERS_INIT-Funktion.

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

Anforderungen

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

Siehe auch

EvtSpbTargetConnect

EvtSpbTargetDisconnect

RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER

SPB_CONNECTION_PARAMETERS_INIT

SpbTargetGetConnectionParameters

  • Last updated on