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，则应用程序必须在此字段中指定通过 GetQueuedCompletionStatus 的 lpCompletionKey 参数返回的值，以将完成消息标识为电话消息。

注解

有关这些选项的详细信息，请参阅 phoneInitializeEx 。

要求

标头	tapi.h

另请参阅

phoneInitializeEx