PHONEINITIALIZEEXPARAMS-Struktur (tapi.h)

  • Artikel

Die PHONEINITIALIZEEXPARAMS-Struktur enthält Parameter, die zum Herstellen der Zuordnung zwischen einer Anwendung und TAPI verwendet werden. Beispielsweise der ausgewählte Ereignisbenachrichtigungsmechanismus der Anwendung. Die phoneInitializeEx-Funktion verwendet diese Struktur.

Syntax

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

Member

dwTotalSize

Dieser Datenstruktur zugeordnete Gesamtgröße in Byte.

dwNeededSize

Größe für diese Datenstruktur, die benötigt wird, um alle zurückgegebenen Informationen in Bytes zu enthalten.

dwUsedSize

Größe des Teils dieser Datenstruktur, der nützliche Informationen in Byte enthält.

dwOptions

Eine der PHONEINITIALIZEEXOPTION_ Konstanten. Gibt den Ereignisbenachrichtigungsmechanismus an, den die Anwendung verwenden möchte.

Handles

Handles.hEvent

Wenn dwOptions PHONEINITIALIZEEXOPTION_USEEVENT angibt, gibt TAPI das Ereignishandle in diesem Member zurück.

Handles.hCompletionPort

Wenn dwOptions PHONEINITIALIZEEXOPTION_USECOMPLETIONPORT angibt, muss die Anwendung in diesem Member das Handle eines vorhandenen Abschlussports angeben, der mit CreateIoCompletionPort geöffnet wurde.

dwCompletionKey

Wenn dwOptions PHONEINITIALIZEEXOPTION_USECOMPLETIONPORT angibt, muss die Anwendung in diesem Feld einen Wert angeben, der über den lpCompletionKey-Parameter von GetQueuedCompletionStatus zurückgegeben wird, um die Abschlussnachricht als Telefonienachricht zu identifizieren.

Hinweise

Weitere Informationen zu diesen Optionen finden Sie unter phoneInitializeEx .

Anforderungen

   
Kopfzeile tapi.h

Weitere Informationen

phoneInitializeEx