Compartilhar via

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

  • Artigo

O método GetEvent recupera informações de evento.

Sintaxe

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

Parâmetros

[in, out] pdwSize

Um ponteiro para um DWORD que contém o tamanho, em bytes, de pEventBuffer. Em caso de êxito, pdwSize retorna o número real de bytes em pEventBuffer. Se pEventBuffer não for grande o suficiente, o método retornará TAPI_E_NOTENOUGHMEMORY e esse parâmetro retornará o número, em bytes, necessário.

pEventBuffer

[in, out, size_is(*pdwSize)] Um ponteiro para o buffer que contém informações de event_info MSP .

Retornar valor

Esse método pode retornar um desses valores.

Valor Significado
S_OK
 O método foi bem-sucedido.
E_NOTIMPL
 Método não implementado.
E_POINTER
 O parâmetro pdwSize ou pEventBuffer não é um ponteiro válido.
E_OUTOFMEMORY
 Existe memória insuficiente para executar a operação.
TAPI_E_NOTENOUGHMEMORY
 O parâmetro pdwSize não era grande o suficiente para o buffer.
TAPI_E_NOEVENT
 Nenhum evento ocorreu.

Comentários

TAPI3 chama esse método quando o identificador de evento dado em initialize é sinalizado. O TAPI chamará esse método repetidamente até que ele falhe para que ele possa obter vários eventos. Cada chamada deve retornar apenas uma estrutura de eventos.

Usuários das classes base msp: esse método bloqueia a lista de eventos.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho msp.h (incluir Tapi3.h)

Confira também

ITMSPAddress

MSPI (Interface do Provedor de Serviços de Mídia)