PHONEINITIALIZEEXPARAMS-Struktur (tapi.h)
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 |