ILMNetDmx::ReadMessage

#include "ILMNetDmx2.h"

C Syntax

HRESULT ILMNetDmx_ReadMessage(pNetDmx, Message)

C++ Syntax

HRESULT ReadMessage(Message)

 

ILMNetDmx *pNetDmx;

/* pointer to an interface */

BSTR *Message;

/* pointer to a string */

Reads a text message sent by the server (LEAD Network Multiplexer).

Parameter

Description

pNetDmx

Pointer to an ILMNetDmx interface.

Message

Pointer to a string to be updated with the message received from the server. On the server side, the message is sent using ILMNetMux::WriteMessage. Received text messages are saved in a queue and can be retrieved one at a time. Call this function repeatedly to check for new messages. Typically, a call every 1 second is sufficient.

Returns

S_OK

The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Required DLLs and Libraries

LMNetDmx
DSKernel

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

ILMNetDmx::put_OutputFileName, ILMNetDmx::get_OutputFileName

Topics:

Video Streaming Function Groups, Multimedia Function Group, DVD Function Groups

Example

For a C or C++ example, refer to A Complete Example: Server and Client.