TSPI_providerCreateLineDevice-Funktion (tspi.h)
Die funktion TSPI_providerCreateLineDevice wird von TAPI als Reaktion auf den Empfang einer LINE_CREATE Nachricht vom Dienstanbieter aufgerufen, die die dynamische Erstellung eines neuen Leitungsgeräts ermöglicht.
Syntax
LONG TSPIAPI TSPI_providerCreateLineDevice(
DWORD_PTR dwTempID,
DWORD dwDeviceID
);
Parameter
dwTempID
Der temporäre Gerätebezeichner, den der Dienstanbieter in der LINE_CREATE-Nachricht an TAPI übergeben hat.
dwDeviceID
Der Gerätebezeichner, den TAPI diesem Gerät zuweist, wenn diese Funktion erfolgreich ist.
Rückgabewert
Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.
Hinweise
Wenn TAPI eine LINE_CREATE Nachricht von einem Dienstanbieter empfängt, wird diese Funktion aufgerufen (diese Funktion wird nie spontan aufgerufen). TAPI fügt der Anzahl der Geräte dieses Typs 1 hinzu und übergibt den resultierenden neuen, nicht verwendeten Gerätebezeichner als dwDeviceID-Parameter an diese Funktion. Außerdem übergibt er in der Funktion den dwParam2-Parameter aus der LINE_CREATE Nachricht als dwTempID.
Ältere Dienstanbieter, die diese Funktion nicht exportieren, sollten jedoch auch keine LINE_CREATE Nachrichten senden, was bedeutet, dass TAPI nicht versuchen würde, diese Funktion aufzurufen.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tspi.h |