Estructura PHONEINITIALIZEEXPARAMS (tapi.h)
La estructura PHONEINITIALIZEEXPARAMS contiene parámetros utilizados para establecer la asociación entre una aplicación y TAPI; por ejemplo, el mecanismo de notificación de eventos seleccionado de la aplicación. La función phoneInitializeEx usa esta estructura.
Sintaxis
typedef struct phoneinitializeexparams_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwOptions;
union {
HANDLE hEvent;
HANDLE hCompletionPort;
} Handles;
DWORD dwCompletionKey;
} PHONEINITIALIZEEXPARAMS, *LPPHONEINITIALIZEEXPARAMS;
Miembros
dwTotalSize
Tamaño total asignado a esta estructura de datos, en bytes.
dwNeededSize
Tamaño de esta estructura de datos necesaria para contener toda la información devuelta, en bytes.
dwUsedSize
Tamaño de la parte de esta estructura de datos que contiene información útil, en bytes.
dwOptions
Una de las constantes de PHONEINITIALIZEEXOPTION_. Especifica el mecanismo de notificación de eventos que la aplicación desea usar.
Handles
Handles.hEvent
Si dwOptions especifica PHONEINITIALIZEEXOPTION_USEEVENT, TAPI devuelve el identificador de eventos en este miembro.
Handles.hCompletionPort
Si dwOptions especifica PHONEINITIALIZEEXOPTION_USECOMPLETIONPORT, la aplicación debe especificar en este miembro el identificador de un puerto de finalización existente abierto mediante CreateIoCompletionPort.
dwCompletionKey
Si dwOptions especifica PHONEINITIALIZEEXOPTION_USECOMPLETIONPORT, la aplicación debe especificar en este campo un valor que se devuelve a través del parámetro lpCompletionKey de GetQueuedCompletionStatus para identificar el mensaje de finalización como un mensaje de telefonía.
Comentarios
Consulte phoneInitializeEx para obtener más información sobre estas opciones.
Requisitos
| Encabezado | tapi.h |