DVMSGID_PLAYEROUTPUTLEVEL

Microsoft® DirectPlay® Voice generates the DVMSGID_PLAYEROUTPUTLEVEL message periodically to notify the user of the output level of an individual player's voice stream. It 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.

DVMSG_PLAYEROUTPUTLEVEL

The DVMSG_PLAYEROUTPUTLEVEL structure contains information for the DVMSGID_PLAYEROUTPUTLEVEL system message.

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

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 is 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 DVMSG_CREATEVOICEPLAYER message structure.

Return Values

Return DV_OK.

Requirements

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