DVMSGID_PLAYEROUTPUTLEVEL Message

Microsoft?DirectPlay?Voice generates the DVMSGID_PLAYEROUTPUTLEVEL message periodically to notify the user of the output level of an individual player's voice stream.

The DVMSG_PLAYEROUTPUTLEVEL structure contains information for the DVMSGID_PLAYEROUTPUTLEVEL system message.

Syntax

typedef struct {
    DWORD dwSize;
    DVID dvidSourcePlayerID;
    DWORD dwPeakLevel;
    PVOID pvPlayerContext;
}  DVMSG_PLAYEROUTPUTLEVEL *LPDVMSG_PLAYEROUTPUTLEVEL, *PDVMSG_PLAYEROUTPUTLEVEL;

Members

dwSize

Size of the DVMSG_PLAYEROUTPUTLEVEL message structure.

dvidSourcePlayerID

DVID of the player whose voice is being played back.

dwPeakLevel

Integer representing the current output level of the player's voice stream. This value must be in the range from 0 through 99, with 0 being completely silent and 99 being the highest possible output level.

pvPlayerContext

Pointer to the context value set for the player. This value is set through the pvPlayerContext member of the DVMSGID_CREATEVOICEPLAYER message structure.

Remarks

Return from the message callback function with DV_OK.

This message is generated while voice is being played back for an individual player. If multiple player voices are being played, one message for each player speaking will be sent each notification period.

The period of notification is set by the dwNotifyPeriod member of the DVCLIENTCONFIG structure. If the notification period is set to 0, this message will not be sent.

Message Information

Header	dvoice.h
Minimum operating systems	Windows 98