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

Weitere Informationen

LINEEVENT

LINE_CREATE

PHONEEVENT

PHONE_CREATE

TSPI_providerInit