Estructuras (RPC)

Hay varias categorías de estructuras, progresivamente más complicadas en términos de acciones necesarias para serializar. Comienzan con una estructura simple que se puede copiar en bloque como un todo y continúan con una estructura compleja que tiene que atender el campo por campo.

• estructura simple
• estructura simple con punteros
• estructura conforme
• estructura conforme con punteros
• estructura variable conforme (con o sin punteros)
• estructura dura
• estructura compleja
• de descripción del diseño de miembro de estructura de

miembros comunes a estructuras

• de alineación

  Alineación necesaria del búfer antes de deshacer la estructura. Los valores válidos son 0, 1, 3 y 7 (la alineación real menos 1).

• memory_size

  Tamaño de la estructura en memoria en bytes; para las estructuras conformes, este tamaño no incluye el tamaño de la matriz.

• offset_to_array_description

  Desplazamiento del puntero de cadena de formato actual a la descripción de la matriz conforme contenida en una estructura.

• member_layout

  Descripción de cada elemento de la estructura. Las rutinas NDR solo necesitan examinar esta parte de la cadena de formato de un tipo si se necesita la transformación endian o si el tipo es una estructura compleja.

• pointer_layout

  Consulte la sección diseño de puntero de.

Estructura simple

Una estructura simple contiene solo tipos base, matrices fijas y otras estructuras simples. La característica principal de la estructura simple es que se puede copiar en bloque como un todo.

FC_STRUCT alignment<1> 
memory_size<2> 
member_layout<> 
FC_END

Estructura simple con punteros

Una estructura simple con punteros contiene solo tipos base, punteros, matrices fijas, estructuras simples y otras estructuras simples con punteros. Dado que el diseño<> solo tendrá que visitarse al realizar una conversión de endianidad, se coloca al final de la descripción.

FC_PSTRUCT alignment<1> 
memory_size<2> 
pointer_layout<> 
member_layout<> 
FC_END

Estructura conforme

Una estructura conforme contiene solo tipos base, matrices fijas y estructuras simples, y debe contener una cadena conforme o una matriz conforme. Esta matriz podría estar contenida en otra estructura conforme o en otra estructura conforme con punteros incrustados en esta estructura.

FC_CSTRUCT alignment<1> 
memory_size<2> 
offset_to_array_description<2> 
member_layout<> 
FC_END

Estructura conforme con punteros

Una estructura conforme con punteros contiene solo tipos base, punteros, matrices fijas, estructuras simples y estructuras simples con punteros; una estructura conforme debe contener una matriz conforme. Esta matriz podría estar contenida en otra estructura conforme o en otra estructura conforme con punteros incrustados en esta estructura.

FC_CPSTRUCT alignment<1> 
memory_size<2> 
offset_to_array_description<2> 
pointer_layout<> 
member_layout<> FC_END

Estructura variable conforme (con o sin punteros)

Una estructura variable conforme contiene solo tipos simples, punteros, matrices fijas, estructuras simples y estructuras simples con punteros; una estructura variable conforme debe contener una cadena conforme o una matriz variable conforme. La cadena o matriz conformes se puede contener realmente en otra estructura o estructura conforme con punteros incrustados en esta estructura.

FC_CVSTRUCT alignment<1> 
memory_size<2> 
offset_to_array_description<2> 
[pointer_layout<>] 
layout<> 
FC_END

Estructura dura

La estructura dura era un concepto destinado a eliminar penalizaciones pronunciadas relacionadas con el procesamiento de estructuras complejas. Se deriva de una observación de que una estructura compleja normalmente tiene solo una o dos condiciones que impiden la copia en bloques y, por tanto, arruinan su rendimiento en comparación con una estructura simple. Los culpables suelen ser uniones o campos de enumeración.

Una estructura dura es una estructura que tiene una enumeración16, un relleno final en la memoria o una unión como último miembro. Estos tres elementos impiden que la estructura caiga en una de las categorías de estructura anteriores, que disfrutan de una pequeña sobrecarga de interpretación y potencial de optimización máxima, pero no la fuerzan en la categoría de estructura compleja muy costosa.

La enumeración 16 no debe hacer que los tamaños de memoria y cable de la estructura difieran. La estructura no puede tener ninguna matriz conforme ni ningún puntero (a menos que parte de la unión); los únicos miembros permitidos son tipos base, matrices fijas y estructuras simples.

FC_HARD_STRUCTURE alignment<1> 
memory_size<2> 
reserved<4> 
enum_offset<2> 
copy_size<2> 
mem_copy_incr<2> 
union_description_offset<2>
member_layout<> 
FC_END

El campo enum_offset<2> proporciona el desplazamiento desde el principio de la estructura en memoria a una enumeración16 si contiene una; de lo contrario, el campo enum_offset<2> es –1.

El campo copy_size<2> proporciona el número total de bytes de la estructura, que se pueden copiar en bloque en o desde el búfer. Este total no incluye ninguna unión final ni ningún relleno final en la memoria. Este valor también es la cantidad en la que se debe incrementar el puntero del búfer después de la copia.

El campo mem_copy_incr<2> es el número de bytes que el puntero de memoria debe incrementarse después de la copia en bloque antes de controlar cualquier unión final. El incremento por esta cantidad (no por copy_size<2> bytes) produce un puntero de memoria adecuado a cualquier unión final.

Estructura compleja

Una estructura compleja es cualquier estructura que contenga uno o varios campos que impidan que la estructura se copie en bloque o para la que se debe realizar una comprobación adicional durante la serialización o desmarshaling (por ejemplo, comprobaciones enlazadas en una enumeración). Los siguientes tipos de NDR se encuentran en esta categoría:

• tipos simples: ENUM16, __INT3264 (solo en plataformas de 64 bits), un entero con [intervalo]
• relleno de alineación al final de la estructura
• punteros de interfaz (usan un complejo incrustado)
• punteros omitido (que están relacionados con [omiten] atributo y token de FC_IGNORE)
• matrices complejas, matrices variables, matrices de cadenas
• Matrices conformes multidimensionales con al menos una dimensión no fija
• uniones
• elementos definidos con [transmit_as], [represent_as], [wire_marshal], [user_marshal]
• estructuras complejas incrustadas
• relleno al final de la estructura

Una estructura compleja tiene la siguiente descripción de formato:

FC_BOGUS_STRUCT alignment<1> 
memory_size<2> 
offset_to_conformant_array_description<2> 
offset_to_pointer_layout<2> 
member_layout<> 
FC_END 
[pointer_layout<>]

El campo memory_size<2> es el tamaño de la estructura en memoria, en bytes.

Si la estructura contiene una matriz conforme, el campo offset_to_conformant_array_description<2> proporciona el desplazamiento a la descripción de la matriz conforme; de lo contrario, es cero.

Si la estructura tiene punteros, el campo offset_to_pointer_layout<2> proporciona el desplazamiento más allá del diseño de la estructura al diseño del puntero; de lo contrario, este campo es cero.

El campo pointer_layout<> de una estructura compleja se controla de forma algo diferente que para otras estructuras. El campo pointer_layout<> de una estructura compleja solo contiene descripciones de campos de puntero reales en la propia estructura. Los punteros contenidos en las matrices, uniones o estructuras incrustados no se describen en el campo pointer_layout<> de la estructura compleja.

El formato del diseño del puntero de una estructura compleja también es radicalmente diferente. Dado que solo contiene descripciones de miembros reales del puntero y porque una estructura compleja se serializa y desmarfa un campo a la vez, el campo de pointer_layout<> simplemente contiene la descripción del puntero de todos los miembros del puntero. No hay FC_PP inicial y ninguna de las pointer_layout<> información habituales.

Descripción del diseño de miembro de estructura

La descripción del diseño de una estructura contiene uno o varios de los siguientes caracteres de formato:

• Cualquiera de los caracteres de tipo base, como FC_CHAR, etc.

• Directivas de alineación. Hay tres caracteres de formato que especifican la alineación del puntero de memoria: FC_ALIGNM2, FC_ALIGNM4 y FC_ALIGNM8.

  Nota

  También hay tokens de alineación del búfer, FC_ALIGNB2 a través de FC_ALIGNM8; no se usan.

   

• Relleno de memoria. Estos se producen solo al final de la descripción de una estructura y indican el número de bytes de relleno en memoria antes de la matriz conforme en la estructura: FC_STRUCTPADn, donde n es el número de bytes de relleno.

• Cualquier tipo no base incrustado (tenga en cuenta, sin embargo, que una matriz conforme nunca se produce en el diseño de la estructura). Tiene una descripción de 4 bytes:

  FC_EMBEDDED_COMPLEX memory_pad<1> 
  offset_to_description<2>,
  

  donde no se garantiza que el desplazamiento esté alineado con 2 bytes.

  memory_pad<1> es un relleno necesario en la memoria antes del campo complejo.

  offset_to_description<2> es un desplazamiento de tipo relativo al tipo incrustado.

También puede haber un FC_PAD antes de que finalice FC_END si es necesario para asegurarse de que la cadena de formato se alineará en un límite de 2 bytes después del FC_END.