estrutura RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER (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 do barramento serial que começa com o elemento 0 da matriz ConnectionProperties .
ConnectionProperties[ANYSIZE_ARRAY]
O primeiro byte do descritor de conexão do 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.
Comentários
O membro ConnectionProperties 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 seguem imediatamente esse membro na memória. O buffer alocado para a estrutura 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 do barramento serial é descrito na especificação ACPI 5.0. Para conveniência, o arquivo de cabeçalho Reshub.h define a estrutura PNP_SERIAL_BUS_DESCRIPTOR para permitir que os drivers acessem os valores nesse 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 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 membro ConnectionParameters 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 Como obter as configurações de conexão de um dispositivo.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte começando com Windows 8. |
| Cabeçalho | reshub.h |