Share via

Структура PHONEINITIALIZEEXPARAMS (tapi.h)

  • Статья

Структура PHONEINITIALIZEEXPARAMS содержит параметры, используемые для установления связи между приложением и TAPI; например, выбранный в приложении механизм уведомления о событиях. Функция phoneInitializeEx использует эту структуру.

Синтаксис

typedef struct phoneinitializeexparams_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwOptions;
  union {
    HANDLE hEvent;
    HANDLE hCompletionPort;
  } Handles;
  DWORD dwCompletionKey;
} PHONEINITIALIZEEXPARAMS, *LPPHONEINITIALIZEEXPARAMS;

Члены

dwTotalSize

Общий размер, выделенный для этой структуры данных, в байтах.

dwNeededSize

Размер этой структуры данных, необходимый для хранения всей возвращаемой информации, в байтах.

dwUsedSize

Размер части этой структуры данных, содержащей полезную информацию, в байтах.

dwOptions

Одна из PHONEINITIALIZEEXOPTION_ констант. Указывает механизм уведомления о событиях, который приложение хочет использовать.

Handles

Handles.hEvent

Если dwOptions указывает PHONEINITIALIZEEXOPTION_USEEVENT, TAPI возвращает дескриптор события в этом элементе.

Handles.hCompletionPort

Если dwOptions указывает PHONEINITIALIZEEXOPTION_USECOMPLETIONPORT, приложение должно указать в этом элементе дескриптор существующего порта завершения, открытого с помощью CreateIoCompletionPort.

dwCompletionKey

Если dwOptions указывает PHONEINITIALIZEEXOPTION_USECOMPLETIONPORT, приложение должно указать в этом поле значение, возвращаемое с помощью параметра lpCompletionKeyобъекта GetQueuedCompletionStatus , чтобы определить сообщение завершения как сообщение телефонии.

Комментарии

Дополнительные сведения об этих параметрах см. в разделе phoneInitializeEx .

Требования

   
Верхняя часть tapi.h

См. также раздел

phoneInitializeEx