ITMSPAddress::GetEvent メソッド (msp.h)

  • [アーティクル]

GetEvent メソッドは、イベント情報を取得します。

構文

HRESULT GetEvent(
  [in, out] DWORD *pdwSize,
            byte  *pEventBuffer
);

パラメーター

[in, out] pdwSize

pEventBuffer のサイズ (バイト単位) を含む DWORD へのポインター。 成功すると、 pdwSize は pEventBuffer の実際のバイト数を返します。 pEventBuffer が十分な大きさでない場合、メソッドは TAPI_E_NOTENOUGHMEMORYを返し、このパラメーターは必要な数 (バイト単位) を返します。

pEventBuffer

[入力、出力、size_is(*pdwSize)] MSP event_info 情報を含むバッファーへのポインター。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値 意味
S_OK
 メソッドが成功しました。
E_NOTIMPL
 メソッドが実装されていません。
E_POINTER
 pdwSize パラメーターまたは pEventBuffer パラメーターが有効なポインターではありません。
E_OUTOFMEMORY
 操作を実行するためのメモリが不足しています。
TAPI_E_NOTENOUGHMEMORY
 pdwSize パラメーターがバッファーに対して十分な大きさではなかった。
TAPI_E_NOEVENT
 イベントは発生しませんでした。

注釈

TAPI3 は、initialize で指定されたイベント ハンドルがシグナル通知されると、このメソッドを呼び出します。 TAPI は、失敗するまでこのメソッドを繰り返し呼び出して、複数のイベントを取得できるようにします。 各呼び出しでは、1 つのイベント構造のみを返す必要があります。

MSP 基本クラスのユーザー: このメソッドは、イベント リストをロックします。

要件

要件 値
対象プラットフォーム Windows
ヘッダー msp.h (Tapi3.h を含む)

こちらもご覧ください

ITMSPAddress

メディア サービス プロバイダー インターフェイス (MSPI)