DVMSGID_OUTPUTLEVEL Message

DirectPlay

 
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

Headerdvoice.h
Minimum operating systems Windows 98

© 2003 Microsoft Corporation. All rights reserved.