estrutura SPB_CONNECTION_PARAMETERS (spbcx.h)

Artigo
02/26/2024

A estrutura SPB_CONNECTION_PARAMETERS contém os parâmetros de conexão de um dispositivo de destino em um barramento periférico simples.

Sintaxe

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

Membros

Size

O tamanho, em bytes, dessa estrutura. O método SpbTargetGetConnectionParameters usa o valor Size para determinar qual versão dessa estrutura está sendo usada. Use a função SPB_CONNECTION_PARAMETERS_INIT para inicializar esse membro. Para obter mais informações, consulte a seção Comentários a seguir.

ConnectionTag

Um ponteiro para a marca de conexão para esse destino. A marca de conexão é uma cadeia de caracteres opaca que contém uma ID de conexão que identifica a conexão do dispositivo de destino com o barramento. Para obter mais informações, consulte IDs de conexão para dispositivos periféricos SPB-Connected.

ConnectionParameters

Um ponteiro para os parâmetros de conexão para esse destino. Esse membro aponta para um buffer de memória que contém os parâmetros específicos de destino que o driver do controlador SPB precisa para se comunicar com o destino. Para obter mais informações, consulte a seção Comentários a seguir.

Comentários

Essa estrutura contém informações sobre a conexão de um dispositivo de destino com o barramento. Quando um cliente (driver periférico) abre uma conexão lógica com o dispositivo de destino, o driver do controlador SPB recupera as configurações de conexão do dispositivo e armazena essas configurações. Posteriormente, em resposta a uma solicitação de E/S do cliente para o dispositivo, o driver do controlador SPB usa as configurações de conexão para configurar o controlador para acessar o dispositivo no barramento.

Por exemplo, as configurações de conexão de um dispositivo em um barramento I2C incluem o seguinte:

O endereço relativo ao barramento do dispositivo de destino.
O número de bits de endereço a serem usados para acessar o dispositivo de destino.
A frequência do relógio do barramento a ser usada para acessar o dispositivo de destino.

O membro ConnectionParameters da estrutura SPB_CONNECTION_PARAMETERS é um ponteiro para um buffer que contém as configurações de conexão de um dispositivo de destino no barramento. Para obter um exemplo de código que usa o membro ConnectionParameters para obter esses parâmetros de conexão, consulte Como obter as configurações de conexão de um dispositivo.

Chame o método SpbTargetGetConnectionParameters para obter os parâmetros de conexão de um identificador SPBTARGET que representa o dispositivo de destino. Esse método grava os parâmetros de conexão em uma estrutura de SPB_CONNECTION_PARAMETERS fornecida pelo chamador. Antes de passar essa estrutura para SpbTargetGetConnectionParameters, inicialize a estrutura chamando a função SPB_CONNECTION_PARAMETERS_INIT .

Para abrir uma conexão em nome de um cliente (driver periférico), a extensão da estrutura SPB (SpbCx) chama a função de retorno de chamada EvtSpbTargetConnect do driver do controlador SPB. Para fechar a conexão, o SpbCx chama a função de retorno de chamada EvtSpbTargetDisconnect do driver do controlador SPB. Um driver de controlador SPB normalmente chama SpbTargetGetConnectionParameters da função EvtSpbTargetConnect do driver.