IDirectPlayVoiceClient::SetNotifyMask メソッド

  • [アーティクル]

IDirectPlayVoiceClient::SetNotifyMask メソッド

メッセージ ハンドラに送信するメッセージを指定する。

構文

HRESULT SetNotifyMask(      
    PDWORD pdwMessageMask,
    DWORD dwMessageMaskElements
);

パラメータ

  • pdwMessageMask
    [in] Microsoft® DirectPlay® Voice がユーザーのコールバック関数に送信するメッセージ識別子を保持する DWORD 値の配列へのポインタ。メッセージ識別子をこの配列に指定しない場合、メッセージは送信されない。それぞれのメッセージ識別子は一度だけ配列に現れるようにすること。また、有効なメッセージ識別子だけが許可される。たとえば、DVMSGID_CONNECTRESULT はサーバーのインターフェイスには無効だが、クライアントのインターフェイスに対しては有効である。すべてのメッセージを有効にするには、この値を NULL に設定する。
  • dwMessageMaskElements
    [in] pdwMessageMask パラメータの要素数を指定する DWORD 値。pdwMessageMask が NULL である場合、パラメータは 0 に設定しておく。

戻り値

成功した場合は DV_OK を返す。または、次のいずれかのエラー値を返す。

DVERR_INVALIDPARAM メソッドに渡された 1 つ以上のパラメータが無効である。
DVERR_INVALIDPOINTER 指定されたポインタが無効である。
DVERR_NOCALLBACK コールバック関数が指定されていないため、この処理は実行できない。
DVERR_NOTINITIALIZED このメソッドを呼び出す前に、IDirectPlayVoiceClient::Initialize メソッドまたは IDirectPlayVoiceServer::Initialize メソッドを呼び出す必要がある。