estructura SPB_CONNECTION_PARAMETERS (spbcx.h)

Artículo
08/07/2023

La estructura SPB_CONNECTION_PARAMETERS contiene los parámetros de conexión de un dispositivo de destino en un bus periférico simple.

Sintaxis

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

Miembros

Size

Tamaño, en bytes, de esta estructura. El método SpbTargetGetConnectionParameters usa el valor Size para determinar qué versión de esta estructura se está usando. Use la función SPB_CONNECTION_PARAMETERS_INIT para inicializar este miembro. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

ConnectionTag

Puntero a la etiqueta de conexión para este destino. La etiqueta de conexión es una cadena opaca que contiene un identificador de conexión que identifica la conexión del dispositivo de destino al bus. Para obtener más información, consulte Identificadores de conexión para SPB-Connected dispositivos periféricos.

ConnectionParameters

Puntero a los parámetros de conexión para este destino. Este miembro apunta a un búfer de memoria que contiene los parámetros específicos del destino que el controlador del controlador SPB necesita para comunicarse con el destino. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Comentarios

Esta estructura contiene información sobre la conexión de un dispositivo de destino al bus. Cuando un cliente (controlador periférico) abre una conexión lógica al dispositivo de destino, el controlador del controlador SPB recupera la configuración de conexión del dispositivo y almacena esta configuración. Más adelante, en respuesta a una solicitud de E/S del cliente al dispositivo, el controlador del controlador SPB usa la configuración de conexión para configurar el controlador para acceder al dispositivo a través del bus.

Por ejemplo, la configuración de conexión de un dispositivo en un bus I2C incluye lo siguiente:

Dirección relativa al bus del dispositivo de destino.
Número de bits de dirección que se van a usar para acceder al dispositivo de destino.
Frecuencia del reloj del bus que se va a usar para acceder al dispositivo de destino.

El miembro ConnectionParameters de la estructura SPB_CONNECTION_PARAMETERS es un puntero a un búfer que contiene la configuración de conexión de un dispositivo de destino en el bus. Para obtener un ejemplo de código que usa el miembro ConnectionParameters para obtener estos parámetros de conexión, consulte Cómo obtener la configuración de conexión de un dispositivo.

Llame al método SpbTargetGetConnectionParameters para obtener los parámetros de conexión de un identificador SPBTARGET que representa el dispositivo de destino. Este método escribe los parámetros de conexión en una estructura de SPB_CONNECTION_PARAMETERS proporcionada por el autor de la llamada. Antes de pasar esta estructura a SpbTargetGetConnectionParameters, inicialice la estructura llamando a la función SPB_CONNECTION_PARAMETERS_INIT .

Para abrir una conexión en nombre de un cliente (controlador periférico), la extensión de marco de SPB (SpbCx) llama a la función de devolución de llamada EvtSpbTargetConnect del controlador SPB. Para cerrar la conexión, SpbCx llama a la función de devolución de llamada EvtSpbTargetDisconnect del controlador SPB. Un controlador del controlador SPB normalmente llama a SpbTargetGetConnectionParameters desde la función EvtSpbTargetConnect del controlador.