Edit

Share via

ITMSPAddress::GetEvent method (msp.h)

  • Article

The GetEvent method retrieves event information.

Syntax

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

Parameters

[in, out] pdwSize

A pointer to a DWORD that contains the size, in bytes, of pEventBuffer. On success, pdwSize returns the actual number of bytes in pEventBuffer. If pEventBuffer is not large enough, the method returns TAPI_E_NOTENOUGHMEMORY and this parameter returns the number, in bytes, required.

pEventBuffer

[in, out, size_is(*pdwSize)] A pointer to buffer that contains MSP event_info information.

Return value

This method can return one of these values.

Value Meaning
S_OK
 Method succeeded.
E_NOTIMPL
 Method not implemented.
E_POINTER
 The pdwSize or pEventBuffer parameter is not a valid pointer.
E_OUTOFMEMORY
 Insufficient memory exists to perform the operation.
TAPI_E_NOTENOUGHMEMORY
 The pdwSize parameter was not large enough for the buffer.
TAPI_E_NOEVENT
 No event has occurred.

Remarks

TAPI3 calls this method when the event handle given in initialize is signaled. TAPI will call this method repeatedly until it fails so it can get multiple events. Each call should return only one event structure.

Users of the MSP base classes: This method locks the event list.

Requirements

Requirement Value
Target Platform Windows
Header msp.h (include Tapi3.h)

See also

ITMSPAddress

Media Service Provider Interface (MSPI)