lineGetDevCaps-Funktion (tapi.h)

Artikel
08/26/2023

Die lineGetDevCaps-Funktion fragt ein angegebenes Leitungsgerät ab, um seine Telefoniefunktionen zu bestimmen. Die zurückgegebenen Informationen sind für alle Adressen auf dem Leitungsgerät gültig.

Syntax

LONG lineGetDevCaps(
  HLINEAPP      hLineApp,
  DWORD         dwDeviceID,
  DWORD         dwAPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

Parameter

hLineApp

Verarbeiten sie die Registrierung der Anwendung bei TAPI.

dwDeviceID

Bezeichner des abzufragten Leitungsgeräts.

dwAPIVersion

Versionsnummer der zu verwendenden Telefonie-API. Das Wort mit hoher Ordnung enthält die Hauptversionsnummer; das Wort mit niedriger Reihenfolge enthält die Nebenversionsnummer. Diese Nummer wird von lineNegotiateAPIVersion abgerufen.

dwExtVersion

Versionsnummer der zu verwendenden Dienstanbieter-spezifischen Erweiterungen. Diese Nummer wird von lineNegotiateExtVersion abgerufen. Es kann null gelassen werden, wenn keine gerätespezifischen Erweiterungen verwendet werden sollen. Andernfalls enthält das Wort mit hoher Ordnung die Hauptversionsnummer. das Wort mit niedriger Reihenfolge enthält die Nebenversionsnummer.

lpLineDevCaps

Zeiger auf eine strukturvariable Größe vom Typ LINEDEVCAPS. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit Informationen zu den Funktionen des Leitungsgeräts gefüllt. Vor dem Aufrufen von lineGetDevCaps muss die Anwendung den dwTotalSize-Member dieser Struktur festlegen, um anzugeben, wie viel Arbeitsspeicher TAPI zum Zurückgeben von Informationen zur Verfügung steht.

Hinweis Wenn die Größenparameter in der Struktur nicht korrekt sind, besteht die Möglichkeit, dass Daten überschrieben werden. Weitere Informationen zum Festlegen von Strukturgrößen finden Sie im Thema speicherbelegung .

Rückgabewert

Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONFAILED, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALAPPHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NODRIVER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.

Hinweise

Vor der Verwendung von lineGetDevCaps muss die Anwendung die API-Versionsnummer aushandeln, um sie zu verwenden, und, falls gewünscht, die zu verwendende Erweiterungsversion.

Die API- und Erweiterungsversionsnummern sind diejenigen, unter denen TAPI und der Dienstanbieter arbeiten müssen. Wenn sich die Versionsbereiche nicht überschneiden, sind die Versionen der Anwendung, API oder Dienstanbieter inkompatibel, und es wird ein Fehler zurückgegeben.

Einer der Member in der LINEDEVCAPS-Struktur , die von dieser Funktion zurückgegeben wird, enthält die Anzahl der Adressen, die dem angegebenen Leitungsgerät zugewiesen sind. Die tatsächlichen Adressbezeichner, die zum Verweisen auf einzelne Adressen verwendet werden, variieren von null bis 1 kleiner als die zurückgegebene Zahl. Die Funktionen jeder Adresse können unterschiedlich sein. Verwenden Sie lineGetAddressCaps für jede verfügbare < Kombination dwDeviceID und dwAddressID>, um die genauen Funktionen der einzelnen Adressen zu bestimmen. Beachten Sie, dass ein Adressbezeichner dauerhaft einer Adresse zugeordnet ist. Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant.