INmChannel
Use the INmChannel interface methods to manage data communication common to all channel types, including audio, video, data, file transfer, and application sharing. All other channel interfaces (INmChannelAudio, INmChannelVideo, INmChannelData, INmChannelFt, and INmChannelAppShare) inherit from this interface.
When to Implement
You do not need to implement this interface because the NetMeeting 3 run time provides the INmChannel implementation on the Channel object. However, you need to implement the corresponding event handler methods for INmChannelNotify.
When to Use
Call the INmChannel methods from your NetMeeting client application to retrieve information about and manage communication channels.
Methods in Vtable Order
| IUnknown methods | Description |
|---|---|
| QueryInterface | Returns pointers to supported interfaces. |
| AddRef | Increments reference count. |
| Release | Decrements reference count. |
| INmChannel methods | Description |
|---|---|
| IsSameAs | Checks whether this channel object and another channel object represent the same channel. |
| IsActive | Checks whether this channel is currently engaged in some activity. |
| SetActive | Activates a channel. |
| GetConference | Finds the conference using this channel. |
| GetInterface | Retrieves the interface identifier (IID) that identifies this channel. |
| GetNmch | Retrieves the NMCH type for this channel. |
| EnumMember | Retrieves an enumerator to list all the members using this channel. |
| GetMemberCount | Retrieves the number of members using this channel. |
Remarks
Channel objects are created by the NetMeeting run time when a conference between two or more members starts or when a conference member initiates a transfer of information (starts chat, whiteboard, file transfer, or application to share) to another Conference member or to the entire conference. You cannot create Channel objects directly. Client applications are notified of members joining, leaving, or changing their data-handling capabilities for a channel through the INmChannelNotify::MemberChanged method.
To list all the channels used by members of a conference, use INmConference::EnumChannel to retrieve an IEnumNmChannel enumerator interface. To retrieve the first member in the list, call Next.
Requirements
** Windows NT/2000:** Requires Windows NT 4.0 SP3 or later.
** Windows 95/98:** Requires Windows 95 or later. Available as a redistributable for Windows 95.
** Header:** Imsconf2.idl.
See Also
INmChannelAudio, INmChannelVideo, INmChannelData, INmChannelFt, INmChannelAppShare