Microsoft DirectX 9.0

IDirectPlayVoiceClient::SetNotifyMask Method

Specifies which messages are sent to the message handler.


HRESULT SetNotifyMask(      

    PDWORD pdwMessageMask,     DWORD dwMessageMaskElements );


[in] Pointer to an array of DWORD values containing the message identifiers that you want Microsoft?DirectPlay?Voice to send to your callback function. If a message identifier is not specified in this array, it is not sent. Each message identifier should appear only once in the array, and only valid message identifiers are allowed. For example, DVMSGID_CONNECTRESULT is not valid for the server interface, but is for the client interface. To enable all messages, set this value to NULL.
[in] DWORD value specifying the number of elements in the pdwMessageMask parameter. If pdwMessageMask is NULL, this parameter must be 0.

Return Value

Returns DV_OK if successful, or one of the following error values.

DVERR_INVALIDPARAMOne or more of the parameters passed to the method are invalid.
DVERR_INVALIDPOINTERThe pointer specified is invalid.
DVERR_NOCALLBACKThis operation cannot be performed because no callback function was specified.
DVERR_NOTINITIALIZEDThe IDirectPlayVoiceClient::Initialize or IDirectPlayVoiceServer::Initialize method must be called before calling this method.

© 2002 Microsoft Corporation. All rights reserved.