次の方法で共有

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_定数の 1 つ。 アプリケーションで使用するイベント通知メカニズムを指定します。

Handles

Handles.hEvent

dwOptions でPHONEINITIALIZEEXOPTION_USEEVENTが指定されている場合、TAPI はこのメンバーのイベント ハンドルを返します。

Handles.hCompletionPort

dwOptions で PHONEINITIALIZEEXOPTION_USECOMPLETIONPORTが指定されている場合、アプリケーションは CreateIoCompletionPort を使用して開かれた既存の完了ポートのハンドルをこのメンバーで指定する必要があります。

dwCompletionKey

dwOptions でPHONEINITIALIZEEXOPTION_USECOMPLETIONPORTが指定されている場合、アプリケーションは、完了メッセージをテレフォニー メッセージとして識別するために、GetQueuedCompletionStatus の lpCompletionKey パラメーターを使用して返される値をこのフィールドに指定する必要があります。

解説

これらのオプションの詳細については、「 phoneInitializeEx 」を参照してください。

要件

   
Header tapi.h

関連項目

phoneInitializeEx