Estructura PHONEBUTTONINFO (tapi.h)

Artículo
03/08/2023

La estructura PHONEBUTTONINFO contiene información sobre un botón en un dispositivo telefónico. Esta estructura se usa en varias funciones TAPI y TSPI.

Sintaxis

typedef struct phonebuttoninfo_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwButtonMode;
  DWORD dwButtonFunction;
  DWORD dwButtonTextSize;
  DWORD dwButtonTextOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwButtonState;
} PHONEBUTTONINFO, *LPPHONEBUTTONINFO;

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.

dwButtonMode

Modo o clase de uso general del botón. Este miembro usa una de las constantes PHONEBUTTONMODE_.

dwButtonFunction

Función asignada al botón. Este miembro usa una de las constantes de PHONEBUTTONFUNCTION_.

dwButtonTextSize

Tamaño del texto descriptivo del botón, en bytes.

dwButtonTextOffset

Desfase desde el principio de esta estructura hasta el campo de tamaño variable que contiene texto descriptivo para este botón. El formato de esta información se especifica en el miembro dwStringFormat de las funcionalidades del dispositivo del teléfono. El tamaño del campo se especifica mediante dwButtonTextSize.

dwDevSpecificSize

Tamaño del campo específico del dispositivo, en bytes. Si el campo específico del dispositivo es un puntero a una cadena, el tamaño debe incluir el terminador nulo .

dwDevSpecificOffset

Desfase desde el principio de la estructura hasta el campo específico del dispositivo de tamaño variable. El tamaño del campo se especifica mediante dwDevSpecificSize.

dwButtonState

Para la función phoneGetButtonInfo , este campo indica el estado actual del botón, usando la PHONEBUTTONSTATE_ Constantes. La función phoneSetButtonInfo omite este campo.

Comentarios

Las extensiones específicas del dispositivo deben usar el área de tamaño variable DevSpecific (dwDevSpecificSize y dwDevSpecificOffset) de esta estructura de datos.

Las aplicaciones anteriores se compilan sin este campo en la estructura PHONEBUTTONINFO y usan un SIZEOF PHONEBUTTONINFO menor que el nuevo tamaño. La aplicación pasa un parámetro dwAPIVersion con la función phoneOpen , que TAPI puede usar para obtener instrucciones para controlar esta situación. Si la aplicación pasa un dwTotalSize menor que el tamaño de la parte fija de la estructura tal como se define en dwAPIVersion especificado, se devuelve PHONEERR_STRUCTURETOOSMALL. Si la aplicación ha asignado suficiente memoria, antes de llamar a la función TSPI_phoneGetButtonInfo , TAPI establece los miembros dwNeededSize y dwUsedSize en el tamaño fijo de la estructura tal como existía en la versión de API especificada.

Los nuevos proveedores de servicios (que admiten la nueva versión de API) deben examinar la versión de API pasada. Si la versión de la API es menor que la versión más alta admitida por el proveedor, el proveedor de servicios no debe rellenar los campos que no se admiten en versiones anteriores de la API, ya que estos caerían en la parte variable de la estructura anterior.

Las nuevas aplicaciones deben ser conscientes de la versión de api negociada y no examinar el contenido de los campos de la parte fija más allá del final original de la parte fija de la estructura para la versión de API negociada.