Método ITMSPAddress::GetEvent (msp.h)

El método GetEvent recupera información de eventos.

Sintaxis

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

Parámetros

[in, out] pdwSize

Puntero a un DWORD que contiene el tamaño, en bytes, de pEventBuffer. Si se ejecuta correctamente, pdwSize devuelve el número real de bytes en pEventBuffer. Si pEventBuffer no es lo suficientemente grande, el método devuelve TAPI_E_NOTENOUGHMEMORY y este parámetro devuelve el número, en bytes, necesario.

pEventBuffer

[entrada, salida, size_is(*pdwSize)] Puntero al búfer que contiene información de event_info MSP .

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Significado
S_OK	El método se realizó correctamente.
E_NOTIMPL	Método no implementado.
E_POINTER	El parámetro pdwSize o pEventBuffer no es un puntero válido.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.
TAPI_E_NOTENOUGHMEMORY	El parámetro pdwSize no era lo suficientemente grande para el búfer.
TAPI_E_NOEVENT	No se ha producido ningún evento.

Comentarios

TAPI3 llama a este método cuando se señala el identificador de evento especificado en initialize. TAPI llamará repetidamente a este método hasta que se produzca un error para que pueda obtener varios eventos. Cada llamada solo debe devolver una estructura de eventos.

Usuarios de las clases base msp: este método bloquea la lista de eventos.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	msp.h (include Tapi3.h)

Consulte también

ITMSPAddress

Interfaz del proveedor de servicios multimedia (MSPI)