Передача структур

Для многих неуправляемых функций в качестве параметра должны быть переданы члены структур (в Visual Basic это определяемые пользователем типы) или члены классов, определяемые в управляемом коде программы. Для сохранения исходного размещения и выравнивания при передаче структур или классов в неуправляемый код необходимо предоставить дополнительные сведения при вызове неуправляемого кода. В этом разделе описывается атрибут StructLayoutAttribute, который можно использовать для определения форматированных типов. Для управляемых структур и классов можно выбрать одно из стандартных размещений, предоставленных перечислением LayoutKind.

Важнейшим из понятий, описанных в этом разделе, является существенное различие между структурами и классами как типами. Структуры представляют собой типы значений, а классы — ссылочные типы, которые всегда обеспечивают, по крайней мере, один уровень косвенного обращения к памяти (указатель на значение). Это различие очень важно, так как неуправляемые функции часто требуют косвенного обращения, что видно из примеров подписей в первом столбце следующей таблицы. Объявления управляемых структур и классов в остальных столбцах показывают, насколько возможна настройка уровня косвенного обращения в объявлении.

The table describes the following guidelines for platform invoke declarations:

• Use a structure passed by value when the unmanaged function demands no indirection.

• Use either a structure passed by reference or a class passed by value when the unmanaged function demands one level of indirection.

• Use a class passed by reference when the unmanaged function demands two levels of indirection

Declaring and Passing Structures

The following example shows how to define the Point and Rect structures in managed code, and pass the types as parameter to the PtInRect function in the User32.dll file. PtInRect has the following unmanaged signature:

Notice that you must pass the Rect structure by reference, since the function expects a pointer to a RECT type.

Эта таблица содержит следующие указания для объявлений вызовов неуправляемого кода:

• Если неуправляемая функция не требует косвенного обращения, структуру следует передавать по значению.

• Если для неуправляемой функции требуется один уровень косвенного обращения, используется либо структура, передаваемая по ссылке, либо класс, передаваемый по значению.

• Если для неуправляемой функции требуется два уровня косвенного обращения, используется класс, передаваемый по ссылке.