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

Consulte también

phoneInitializeEx