TSPI_providerEnumDevices-Funktion (tspi.h)
TAPI ruft die TSPI_providerEnumDevices-Funktion auf, bevor TSPI_providerInit , um die Anzahl der vom Dienstanbieter unterstützten Leitungs- und Telefongeräte zu ermitteln.
Syntax
LONG TSPIAPI TSPI_providerEnumDevices(
DWORD dwPermanentProviderID,
LPDWORD lpdwNumLines,
LPDWORD lpdwNumPhones,
HPROVIDER hProvider,
LINEEVENT lpfnLineCreateProc,
PHONEEVENT lpfnPhoneCreateProc
);
Parameter
dwPermanentProviderID
Der permanente Bezeichner, der innerhalb der Dienstanbieter auf diesem System eindeutig ist, des Dienstanbieters, der initialisiert wird.
lpdwNumLines
Ein Zeiger auf einen DWORD-Speicherspeicherort, in den der Dienstanbieter die Anzahl der Leitungsgeräte schreiben muss, die für die Unterstützung konfiguriert sind. TAPI initialisiert den Wert auf 0. Wenn der Dienstanbieter also keinen anderen Wert schreibt, wird der Wert 0 angenommen.
lpdwNumPhones
Ein Zeiger auf einen DWORD-Speicherspeicherort, in den der Dienstanbieter die Anzahl der Telefongeräte schreiben muss, die für die Unterstützung konfiguriert sind. TAPI initialisiert den Wert auf 0. Wenn der Dienstanbieter also keinen anderen Wert schreibt, wird der Wert 0 angenommen.
hProvider
Ein undurchsichtiger DWORD-Wert, der diese instance dieses Dienstanbieters während dieser Ausführung der Telefonieumgebung eindeutig identifiziert.
lpfnLineCreateProc
Ein Zeiger auf die von TAPI bereitgestellte LINEEVENT-Rückrufprozedur . Der Dienstanbieter verwendet diese Funktion, um LINE_CREATE Nachrichten zu senden, wenn ein neues Leitungsgerät erstellt werden muss.
lpfnPhoneCreateProc
Ein Zeiger auf die phoneevent-Rückrufprozedur , die von TAPI bereitgestellt wird. Der Dienstanbieter verwendet diese Funktion, um PHONE_CREATE Nachrichten zu senden, wenn ein neues Telefongerät erstellt werden muss.
Rückgabewert
Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
LINEERR_NOMEM, LINEERR_OPERATIONFAILED.
Hinweise
In früheren Versionen von TAPI war die Implementierung dieser Funktion optional. Ab TAPI 2.0 ist die Implementierung dieser Funktion in allen Dienstanbietern obligatorisch. TAPI überprüft beim TAPI-Start nicht mehr Telephon.ini oder die Registrierung, um die anfängliche Anzahl von Leitungen und Telefonen zu ermitteln, die von einem Dienstanbieter unterstützt werden.
Ein neues Gerät kann vor Abschluss des TSPI_providerInit-Verfahrens angezeigt werden. TAPI verarbeitet alle _CREATE Nachrichten während der Anbieterinitialisierung ordnungsgemäß.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |