Microsoft DirectX 9.0 SDK Update (Summer 2003) |
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