Estrutura PHONEINITIALIZEEXPARAMS (tapi.h)
A estrutura PHONEINITIALIZEEXPARAMS contém parâmetros usados para estabelecer a associação entre um aplicativo e TAPI; por exemplo, o mecanismo de notificação de eventos selecionado do aplicativo. A função phoneInitializeEx usa essa estrutura.
Sintaxe
typedef struct phoneinitializeexparams_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwOptions;
union {
HANDLE hEvent;
HANDLE hCompletionPort;
} Handles;
DWORD dwCompletionKey;
} PHONEINITIALIZEEXPARAMS, *LPPHONEINITIALIZEEXPARAMS;
Membros
dwTotalSize
Tamanho total alocado para essa estrutura de dados, em bytes.
dwNeededSize
Tamanho para essa estrutura de dados necessária para armazenar todas as informações retornadas, em bytes.
dwUsedSize
Tamanho da parte dessa estrutura de dados que contém informações úteis, em bytes.
dwOptions
Uma das constantes PHONEINITIALIZEEXOPTION_. Especifica o mecanismo de notificação de eventos que o aplicativo deseja usar.
Handles
Handles.hEvent
Se dwOptions especificar PHONEINITIALIZEEXOPTION_USEEVENT, TAPI retornará o identificador de evento neste membro.
Handles.hCompletionPort
Se dwOptions especificar PHONEINITIALIZEEXOPTION_USECOMPLETIONPORT, o aplicativo deverá especificar neste membro o identificador de uma porta de conclusão existente aberta usando CreateIoCompletionPort.
dwCompletionKey
Se dwOptions especificar PHONEINITIALIZEEXOPTION_USECOMPLETIONPORT, o aplicativo deverá especificar neste campo um valor retornado por meio do parâmetro lpCompletionKey de GetQueuedCompletionStatus para identificar a mensagem de conclusão como uma mensagem de telefonia.
Comentários
Consulte phoneInitializeEx para obter mais informações sobre essas opções.
Requisitos
| Cabeçalho | tapi.h |