共用方式為

ITMSPAddress：：GetEvent 方法 (msp.h)

  • 發行項

GetEvent 方法會擷取事件資訊。

語法

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

參數

[in, out] pdwSize

DWORD 的指標，其中包含 pEventBuffer 的大小，以位元組為單位。 成功時， pdwSize 會傳回 pEventBuffer 中的實際位元組數目。 如果 pEventBuffer 不夠大，方法會傳回 TAPI_E_NOTENOUGHMEMORY， 而此參數會傳回所需的數位，以位元組為單位。

pEventBuffer

[in， out， size_is (*pdwSize) ]緩衝區的指標，其中包含 MSP event_info 資訊。

傳回值

這個方法可以傳回其中一個值。

值 意義
S_OK
 方法成功。
E_NOTIMPL
 未實作的方法。
E_POINTER
 pdwSize 或 pEventBuffer 參數不是有效的指標。
E_OUTOFMEMORY
 記憶體不足，無法執行作業。
TAPI_E_NOTENOUGHMEMORY
 pdwSize 參數不足以用於緩衝區。
TAPI_E_NOEVENT
 未發生任何事件。

備註

當初始化中指定的事件句柄發出訊號時，TAPI3 會呼叫此方法。 TAPI 會重複呼叫這個方法，直到它失敗，才能取得多個事件。 每個呼叫都應該只傳回一個事件結構。

MSP 基類的使用者：此方法會鎖定事件清單。

規格需求

需求 值
目標平台 Windows
標頭 msp.h (包含Tapi3.h)

另請參閱

ITMSPAddress

媒體服務提供者介面 (MSPI)