estrutura SPB_CONNECTION_PARAMETERS (spbcx.h)
A estrutura SPB_CONNECTION_PARAMETERS contém os parâmetros de conexão de um dispositivo de destino em um de barramento periféricosimples.
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 tamanho 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.
Observações
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 para o 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 pelo barramento.
Por exemplo, as configurações de conexão de um dispositivo em um barramento I2C incluem o seguinte:
- O endereço relativo do 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.
Chame o método SpbTargetGetConnectionParameters para obter os parâmetros de conexão para 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 o driver do controlador SPB EvtSpbTargetConnect função de retorno de chamada. Para fechar a conexão, o SpbCx chama o driver do controlador SPB EvtSpbTargetDisconnect função de retorno de chamada. Um driver de controlador SPB normalmente chama SpbTargetGetConnectionParameters da função EvtSpbTargetConnect do driver.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte a partir do Windows 8. |
| cabeçalho | spbcx.h |
Consulte também
RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER