Поделиться через

Метод 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)] Указатель на буфер, содержащий сведения о event_info MSP .

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Значение Значение
S_OK
 Метод успешно выполнен.
E_NOTIMPL
 Метод не реализован.
E_POINTER
 Параметр pdwSize или pEventBuffer не является допустимым указателем.
E_OUTOFMEMORY
 Для выполнения операции недостаточно памяти.
TAPI_E_NOTENOUGHMEMORY
 Параметр pdwSize не был достаточно велик для буфера.
TAPI_E_NOEVENT
 Событие не произошло.

Комментарии

TAPI3 вызывает этот метод при сигнале дескриптора события, заданного в параметре initialize. TAPI будет вызывать этот метод несколько раз, пока он не завершится ошибкой, чтобы получить несколько событий. Каждый вызов должен возвращать только одну структуру событий.

Пользователи базовых классов MSP. Этот метод блокирует список событий.

Требования

Требование Значение
Целевая платформа Windows
Header msp.h (включая Tapi3.h)

См. также раздел

ITMSPAddress

Интерфейс поставщика служб мультимедиа (MSPI)