função MI_Context_WriteStreamParameter (mi.h)

Envia dados de parâmetro transmitidos para o cliente para uma invocação de método.

Sintaxe

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
);

Parâmetros

[in] self

Contexto da solicitação.

[in] name

Uma cadeia de caracteres terminada em nulo que representa o nome do parâmetro de método a ser transmitido.

[in] value

Uma entidade de tipo de valor.

[in] type

MI_Type objeto que indica o tipo que está sendo transmitido.

[in] flags

Deve ser 0 ou MI_FLAG_NULL.

MI_FLAG_NULL (0x20000000)

O final do fluxo foi atingido.

Valor retornado

Um valor da enumeração MI_Result que especifica o código de retorno da função. Esse pode ser um dos códigos a seguir.

Comentários

Os parâmetros de saída do método de matriz podem ser marcados como transmitidos, o que significa que, em vez de enviar todos os parâmetros em uma parte, eles são transmitidos para o cliente. Os dados de parâmetro transmitidos permitem que o cliente exiba dados de maneira mais suave em vez de ter que esperar até que todos os dados sejam enviados. Isso dá à interface do usuário uma sensação mais suave e consistente. O valor pode ser uma matriz que contém um ou mais elementos do tipo especificado. Chame essa função repetidamente para enviar todo o fluxo. Se o cliente não manipular parâmetros transmitidos, o servidor armazenará em cache todos os resultados e os enviará ao cliente de uma só vez. No caso dos resultados serem armazenados em cache quando grandes conjuntos de resultados são gerados, o provedor pode exceder as cotas e ser desligado, o que significa que os métodos que geram conjuntos de resultados muito grandes podem funcionar apenas com clientes que dão suporte ao streaming.

Requisitos

Confira também

MI_Context

MI_Type