Microsoft DirectX 8.1 (C++)

IDirectPlayVoiceClient::SetNotifyMask

Specifies which messages are sent to the message handler.

HRESULT SetNotifyMask(
PDWORD pdwMessageMask,
DWORD dwMessageMaskElements
);

Parameters

pdwMessageMask
[in] Pointer to an array of DWORDs 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, specify NULL for this value.
dwMessageMaskElements
[in] Number of elements specified in the pdwMessageMask parameter. If pdwMessageMask is NULL, this must be 0.

Return Values

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

DVERR_INVALIDPARAM
DVERR_INVALIDPOINTER
DVERR_NOCALLBACK
DVERR_NOTINITIALIZED

Requirements

  Windows NT/2000/XP: Available as a redistributable for Windows 2000 and later.
  Windows 98/Me: Available as a redistributable for Windows 98 and later.
  Header: Declared in Dvoice.h.