estructura RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER (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
Tamaño, en bytes, del descriptor de conexión de bus serie que comienza con el elemento 0 de la matriz ConnectionProperties de .
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 connectionProperties miembro usa la constante ANYSIZE_ARRAY, que el archivo de encabezado Ntdef.h define como 1. Para obtener más información, vea Comentarios.
Observaciones
El ConnectionProperties miembro 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 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 de 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 simple de bus periférico (normalmente, I²C o SPI). Este método escribe los parámetros de conexión en una estructura de SPB_CONNECTION_PARAMETERS y el ConnectionParameters miembro 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 | Valor |
|---|---|
| cliente mínimo admitido | Se admite a partir de Windows 8. |
| encabezado de | reshub.h |