функция MI_Context_WriteStreamParameter (mi.h)

Отправляет потоковые данные параметров клиенту для вызова метода.

Синтаксис

MI_INLINE MI_Result MI_INLINE_CALL MI_Context_WriteStreamParameter(
  [in] MI_Context     *self,
  [in] const MI_Char  *name,
  [in] const MI_Value *value,
  [in] MI_Type        type,
  [in] MI_Uint32      flags
);

Параметры

[in] self

Контекст запроса.

[in] name

Строка, завершающаяся нулевым значением, представляющая имя параметра метода для потоковой передачи.

[in] value

Сущность типа значения.

[in] type

MI_Type объект , указывающий тип потоковой передачи.

[in] flags

Должно быть 0 или MI_FLAG_NULL.

MI_FLAG_NULL (0x20000000)

Достигнут конец потока.

Возвращаемое значение

Значение перечисления MI_Result , указывающее код возврата функции. Это может быть один из следующих кодов.

Комментарии

Параметры out массива можно пометить как потоковые. Это означает, что вместо отправки всех параметров в одном блоке они передаются клиенту. Данные параметров потоковой передачи позволяют клиенту более плавно отображать данные, не дожидаясь отправки всех данных. Это обеспечивает более плавное и согласованное взаимодействие с пользовательским интерфейсом. Значением может быть массив, содержащий один или несколько элементов указанного типа. Вызовите эту функцию несколько раз, чтобы отправить весь поток. Если клиент не обрабатывает потоковые параметры, сервер будет кэшировать все результаты и отправлять их клиенту одновременно. В случае кэширования результатов при создании больших результирующих наборов поставщик может превысить квоты и завершить работу. Это означает, что методы, создающие очень большие результирующие наборы, могут работать только с клиентами, поддерживающими потоковую передачу.

Требования

См. также раздел

MI_Context

MI_Type