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