Microsoft DirectX 8.0 (C++)

IDirectPlayVoiceServer::SetTransmitTargets

Controls the transmission of audio from the client to the specified members of the session.

HRESULT SetTransmitTargets(
DVID dvSource,
PDVID pdvIDTargets,
DWORD dwNumTargets,
DWORD dwFlags
);

Parameters

dvSource
DVID of the user whose targets are set.
pdvIDTargets
List of player DVIDs and/or group DVIDs that are the target for audio transmission. To specify no targets, pass NULL for this parameter. Additionally, this parameter can be set to the following value.
DVID_ALLPLAYERS
This client is targeting all players in the session. This must be the only element in the array.
dwNumTargets
Number of DVIDs in the array. This value cannot exceed 64. If pdvIDTargets is NULL this must be 0.
dwFlags
Reserved. Must be 0.

Return Values

Returns DV_OK if successful, or one of the following error values.

DVERR_INVALIDFLAGS
DVERR_INVALIDPARAM
DVERR_INVALIDPOINTER
DVERR_INVALIDTARGET
DVERR_NOTALLOWED
DVERR_NOTINITIALIZED

Remarks

For Microsoft® DirectX® 8.0, the number of individual targets that you can transmit to is limited to 64. If you exceed this value, the method will fail, and return DVERR_NOTALLOWED. However, you can transmit to more than 64 players. To do so, form the players into groups, and then use the group as your target.

There must be no duplicate targets in this parameter, and all entries must be valid DVIDs. If a target contains a player as its individual DVID and through a group that the target belongs to, Microsoft® DirectPlay® Voice ensures duplicate speech packets are not sent to the player.

This method can be used only if the DVSESSION_SERVERCONTROLTARGET flag is specified on creation of the DirectPlay Voice session. If the flag is not specified, this method returns DVERR_NOTALLOWED.

Requirements

  Windows NT/2000: Available as a redistributable for Windows 2000 and later.
  Windows 95/98: Available as a redistributable for Windows 95 and later.
  Header: Declared in Dvoice.h.