DVMSGID_OUTPUTLEVEL Message

Microsoft® DirectPlay® Voice generates the DVMSGID_OUTPUTLEVEL message periodically to notify the user of the output level of playback.

The DVMSG_OUTPUTLEVEL structure contains information for the DVMSGID_OUTPUTLEVEL system message.

Syntax

typedef struct {
    DWORD dwSize;
    DWORD dwPeakLevel;
    LONG lOutputVolume;
    PVOID pvLocalPlayerContext;
}  DVMSG_OUTPUTLEVEL *LPDVMSG_OUTPUTLEVEL, *PDVMSG_OUTPUTLEVEL;

Members

dwSize

Size of the DVMSG_OUTPUTLEVEL message structure.

dwPeakLevel

Integer representing the current output level of playback. This value must be in the range from 0 through 99. 0 indicates complete silence and 99 indicates the highest possible output level.

lOutputVolume

Current playback volume for the client.

pvLocalPlayerContext

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

Remarks

Return from the message callback function with DV_OK.

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