RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER estructura (reshub.h)
La estructura RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER contiene las propiedades de conexión de un dispositivo de destino que está conectado a un bus serie (I2C, SPI o UART).
Sintaxis
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;
Miembros
Version
Número de versión de esta estructura. Este miembro se establece en la constante RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_VERSION, que se define en el archivo de encabezado Reshub.h.
PropertiesLength
El tamaño, en bytes, del descriptor de conexión de bus serie que comienza por el elemento 0 de la matriz ConnectionProperties .
ConnectionProperties[ANYSIZE_ARRAY]
Primer byte del descriptor de conexión de bus serie. Este byte va seguido inmediatamente de los bytes restantes del descriptor. El miembro PropertiesLength especifica el número total de bytes ocupados por el descriptor. La definición del miembro ConnectionProperties usa la constante ANYSIZE_ARRAY, que el archivo de encabezado Ntdef.h define como 1. Para obtener más información, vea la sección Comentarios.
Comentarios
El miembro ConnectionProperties de la estructura RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER contiene el primer byte del descriptor de conexión de bus serie para el dispositivo de destino. Los bytes restantes del descriptor siguen inmediatamente a este miembro en la memoria. El búfer asignado para la estructura de RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER es lo suficientemente grande como para contener esta estructura más los bytes restantes del descriptor de conexión del bus serie que se extienden más allá del final de la estructura.
El formato del descriptor de conexión de bus serie se describe en la especificación ACPI 5.0. Para mayor comodidad, el archivo de encabezado Reshub.h define la estructura PNP_SERIAL_BUS_DESCRIPTOR para permitir que los controladores accedan a los valores de este descriptor.
Un controlador de controlador SPB llama al método SpbTargetGetConnectionParameters para obtener los parámetros de conexión de un dispositivo de destino en un bus periférico simple (normalmente, I²C o SPI). Este método escribe los parámetros de conexión en una estructura de SPB_CONNECTION_PARAMETERS y el miembro ConnectionParameters de esta estructura es un puntero a una estructura RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER .
Para obtener un ejemplo de código que usa la estructura de RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER , vea Cómo obtener la configuración de conexión de un dispositivo.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Se admite a partir de Windows 8. |
| Encabezado | reshub.h |