RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER estrutura (reshub.h)
A estrutura RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER contém as propriedades de conexão de um dispositivo de destino conectado a um barramento serial (I2C, SPI ou UART).
Sintaxe
typedef struct _RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER {
ULONG Version;
ULONG PropertiesLength;
UCHAR ConnectionProperties[ANYSIZE_ARRAY];
} RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER, *PRH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER;
Membros
Version
O número de versão dessa estrutura. Esse membro é definido como a constante RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_VERSION, que é definida no arquivo de cabeçalho Reshub.h.
PropertiesLength
O tamanho, em bytes, do descritor de conexão de barramento serial que começa com o elemento 0 da matriz ConnectionProperties.
ConnectionProperties[ANYSIZE_ARRAY]
O primeiro byte do descritor de conexão de barramento serial. Esse byte é imediatamente seguido pelos bytes restantes do descritor. O membro PropertiesLength especifica o número total de bytes ocupados pelo descritor. A definição do membro ConnectionProperties usa a constante ANYSIZE_ARRAY, que o arquivo de cabeçalho Ntdef.h define como 1. Para obter mais informações, consulte Comentários.
Observações
O ConnectionProperties membro da estrutura RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER contém o primeiro byte do descritor de conexão de barramento serial para o dispositivo de destino. Os bytes restantes no descritor imediatamente seguem esse membro na memória. O buffer alocado para a estrutura de RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER é grande o suficiente para conter essa estrutura mais os bytes restantes do descritor de conexão de barramento serial que se estendem além do final da estrutura.
O formato do descritor de conexão de barramento serial é descrito na especificação ACPI 5.0. Para conveniência, o arquivo de cabeçalho Reshub.h define a estrutura de PNP_SERIAL_BUS_DESCRIPTOR para permitir que os drivers acessem os valores neste descritor.
Um driver de controlador SPB chama o método SpbTargetGetConnectionParameters para obter os parâmetros de conexão de um dispositivo de destino em um de barramento periférico simples (normalmente, I²C ou SPI). Esse método grava os parâmetros de conexão em uma estrutura SPB_CONNECTION_PARAMETERS e o ConnectionParameters membro dessa estrutura é um ponteiro para uma estrutura RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER.
Para obter um exemplo de código que usa a estrutura RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER, consulte How to Get the Connection Settings for a Device.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte a partir do Windows 8. |
| cabeçalho | reshub.h |