IDirectPlayVoiceClient::SetNotifyMask Method

Specifies which messages are sent to the message handler.

Syntax

HRESULT SetNotifyMask(      
    PDWORD pdwMessageMask,
    DWORD dwMessageMaskElements
);

Parameters

pdwMessageMask

[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.

dwMessageMaskElements

[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_INVALIDPARAM	One or more of the parameters passed to the method are invalid.
DVERR_INVALIDPOINTER	The pointer specified is invalid.
DVERR_NOCALLBACK	This operation cannot be performed because no callback function was specified.
DVERR_NOTINITIALIZED	The IDirectPlayVoiceClient::Initialize or IDirectPlayVoiceServer::Initialize method must be called before calling this method.